home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / ra_003.zip / RA.DOC < prev    next >
Text File  |  1990-04-30  |  189KB  |  5,979 lines
  1.  
  2.                 
  3.  
  4.  
  5.  
  6.  
  7.                                                                     
  8.                                
  9.                                                                     
  10.                                    
  11.                                                                     
  12.                                    
  13.                                                                     
  14.                                    
  15.                                                                     
  16.                                    
  17.                                                                     
  18.                                    
  19.          
  20.                                                                                
  21.                                                                                
  22.       ┌─────────┐┌───────┐ ┌────────────┐┌──────────┬───────────┬───────┐
  23.       │  ┌───┐  ││   ┌───┘ │  ┌─┐  ┌─┐  ││  ┌───┐   ├────┐  ┌───┤   ┌───┘
  24.       │  │   │  ││   └───┐ │  │ │  │ │  ││  │   │   │    │  │   │   └───┐
  25.       │  └───┘  └┤   ┌───┘ │  │ │  │ │  └┤  │   │   └┐   │  └┐  │   ┌───┘
  26.       │  ┌────┐  │   └─────┤  │ │  │ │   │  └───┘    │   │   │  │   └─────┐
  27.       │  │    │  │         │  │ │  │ │   │           │   │   │  │         │
  28.       └──┘    └──┴─────────┴──┘ └──┘ └───┴───────────┘   └───┘  └─────────┘
  29.         
  30.                                                                                
  31.            ┌──────────┬──────┐ ┌──────┐ ┌───────┐ ┌───────┐ ┌───────┐
  32.            │  ┌───┐   │   ┌──┘ │   ┌──┘ │   ┌───┘ │   ┌───┘ │   ┌───┘
  33.            │  │   │   │   │    │   │    │   └───┐ │   └─────┤   └─────┐
  34.            │  └───┘   │   │    │   │    │   ┌───┘ └─────┐   ├─────┐   │
  35.            │  ┌────┐  │   └────┤   └────┤   └─────┬─────┘   ├─────┘   │
  36.            │  │    │  │        │        │         │         │         │
  37.            └──┘    └──┴────────┴────────┴─────────┴─────────┴─────────┘
  38.             
  39.                                                          
  40.                                                                                
  41.   
  42.                                   RemoteAccess v0.03 
  43.  
  44.                 (C) 1989,90 Continental Software, All Rights Reserved
  45.              
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.        TABLE OF CONTENTS
  64.        ────────────────────────────────────────────────────────────
  65.  
  66.        PREAMBLE AND CREDITS  . . . . . . . . . . . . . . . . .    2
  67.  
  68.        OVERVIEW AND FEATURES . . . . . . . . . . . . . . . . .    3
  69.  
  70.        LICENSING INFORMATION . . . . . . . . . . . . . . . . .    5
  71.  
  72.        HOW TO REGISTER . . . . . . . . . . . . . . . . . . . .    6
  73.             REGISTRATION FORM  . . . . . . . . . . . . . . . .    8
  74.             The key system . . . . . . . . . . . . . . . . . .    9
  75.  
  76.        PRODUCT SUPPORT . . . . . . . . . . . . . . . . . . . .   10
  77.  
  78.        INSTALLATION  . . . . . . . . . . . . . . . . . . . . .   11
  79.  
  80.        CONFIGURATION . . . . . . . . . . . . . . . . . . . . .   12
  81.             QuickBBS to RemoteAccess . . . . . . . . . . . . .   12
  82.             RACONFIG . . . . . . . . . . . . . . . . . . . . .   13
  83.             Events . . . . . . . . . . . . . . . . . . . . . .   24
  84.             Files  . . . . . . . . . . . . . . . . . . . . . .   25
  85.             Message areas  . . . . . . . . . . . . . . . . . .   26
  86.  
  87.        SECURITY  . . . . . . . . . . . . . . . . . . . . . . .   28
  88.  
  89.        MENUS . . . . . . . . . . . . . . . . . . . . . . . . .   29
  90.             Menu functions . . . . . . . . . . . . . . . . . .   30
  91.             Automatic command execution  . . . . . . . . . . .   53
  92.             Menu templates . . . . . . . . . . . . . . . . . .   54
  93.             Setting up your menus  . . . . . . . . . . . . . .   56
  94.             Creating your menus - RAMENU . . . . . . . . . . .   57
  95.  
  96.        EXTERNAL SUPPORT FILES  . . . . . . . . . . . . . . . .   59
  97.             LIMITS.CTL . . . . . . . . . . . . . . . . . . . .   62
  98.             PHONENUM.CTL . . . . . . . . . . . . . . . . . . .   63
  99.             PWDTRASH.CTL . . . . . . . . . . . . . . . . . . .   63
  100.             TRASHCAN.CTL . . . . . . . . . . . . . . . . . . .   63
  101.  
  102.        THE USER FILE . . . . . . . . . . . . . . . . . . . . .   64
  103.             Packing and sorting the user file  . . . . . . . .   65
  104.  
  105.        THE MESSAGE DATABASE - RAMSG  . . . . . . . . . . . . .   66
  106.  
  107.        MAIL NETWORKING . . . . . . . . . . . . . . . . . . . .   71
  108.             Installing the nodelist files  . . . . . . . . . .   74
  109.  
  110.        MULTI - NODE OPERATION  . . . . . . . . . . . . . . . .   76
  111.  
  112.        REFERENCE SECTION . . . . . . . . . . . . . . . . . . .   79
  113.             Sysop keys . . . . . . . . . . . . . . . . . . . .   79
  114.             Command-line parameters  . . . . . . . . . . . . .   81
  115.             Errorlevels  . . . . . . . . . . . . . . . . . . .   83
  116.             Text file control codes  . . . . . . . . . . . . .   84
  117.                  User Parameter Codes  . . . . . . . . . . . .   86
  118.                  System Parameter Codes  . . . . . . . . . . .   87
  119.             Modem string translation . . . . . . . . . . . . .   88
  120.             Questionnaire script language  . . . . . . . . . .   89
  121.  
  122.  
  123.  
  124.        BATCH FILE EXAMPLES . . . . . . . . . . . . . . . . . .   93
  125.             RemoteAccess stand-alone . . . . . . . . . . . . .   93
  126.             RemoteAccess with a mailer . . . . . . . . . . . .   94
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.        The  following  products and names are the copyrighted 
  186.        material  and  or  trademarks  of  their  copyright  and  or
  187.        trademark holders respectively:
  188.  
  189.  
  190.        QuickBBS,                
  191.        Echogen & QEcho          The QuickBBS Group, Inc.
  192.        DESQview                 Quarterdeck Systems
  193.        DoubleDOS                SoftLogic Systems  
  194.        TradeWars                Chris Sherrick
  195.        Opus                     Wynn Wagner III
  196.        TosScan & FrontDoor      Joaquim H. Homrighausen
  197.        BinkleyTerm              Bit Bucket Software
  198.        D'Bridge                 Chris Irwin
  199.        ZmailQ                   Claude N. Warren
  200.        FidoNet                  Tom Jennings
  201.        IBM                      International Business Machines
  202.        ParaNet                  ParaNet Information Systems
  203.        MS-DOS                   Microsoft Corporation
  204.        X00                      Ray Gwinn
  205.        BNU                      David Nugent
  206.        Turbo Pascal             Borland International
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                      1
  246.        PREAMBLE AND CREDITS
  247.        ────────────────────────────────────────────────────────────
  248.  
  249.        Firstly,  let me say that RemoteAccess was very much a  team
  250.        effort.  I  had  been running my bulletin board for about  a
  251.        year,  it was getting pretty busy so I put on a second line.
  252.        The  software I was using was QuickBBS,  so I did a heap  of
  253.        work trying to get it running both lines.  For the most part
  254.        it worked,  but it was very clumsy. I was complaining to Bob
  255.        Fletcher,  a sysop in Victoria, about it one night, and  Bob
  256.        said  something  like "Well,  YOU could always have a go  at
  257.        something better!" So the basic concept was born.  An  "all-
  258.        singing,  all-dancing"  BBS package that would run  multiple
  259.        lines  and  occupy as little memory as possible.  "Piece  of
  260.        cake!" I thought.  In my spare time I started playing around
  261.        with a couple of file-displaying utilities written in  Turbo
  262.        Pascal  5  (which  I had just bought,  and  was  anxious  to
  263.        learn.)
  264.  
  265.        Enter  Phil.  Someone mentioned that "some bloke called Phil
  266.        Mackay" was writing a toolbox of routines to manipulate  the
  267.        QuickBBS  message and user database files so I dropped him a
  268.        message.  Phil was immediately taken by the idea and sent me
  269.        the source to what he had written.  I was impressed.  As  it
  270.        happened,  Bob was in Perth at this time and during a couple
  271.        of  brainstorming  sessions helped to refine what I  already
  272.        had (which wasn't much).
  273.  
  274.        Gradually I started to spend more and more of my spare  time
  275.        working  on  it,  and I started to realise the scale of  the
  276.        project (which still kinda frightens me).  I realised  there
  277.        was no way I could do it all myself,  so I enlisted the help
  278.        of  one or two other people to write utilities,  and "farmed
  279.        out" a fair bit of coding to Phil.  All the following people
  280.        deserve recognition for their contributions:
  281.  
  282.        Phil  Mackay - all the high and low-level  message  database
  283.        routines,   the  menu  editor  and  an  infinite  number  of
  284.        suggestions,  not  to  mention  invaluable  advice  on  many
  285.        occasions.
  286.  
  287.        David  Nugent - Wrote the message-base  maintenance  utility
  288.        "RAMSG",  was  ALWAYS ready to provide answers to  any  low-
  289.        level  communications  problem,  and wrote the  multitasker-
  290.        aware code.
  291.  
  292.        Adam  Blake  - Did the configuration utility "RACONFIG"  and
  293.        changed  it  twice a day when I made more mods to  the  main
  294.        program, uncomplainingly. (Well, almost).
  295.  
  296.        The  beta  test team - thanks guys!  Couldn't have  done  it
  297.        without ya.  Too numerous to list here, all the current beta
  298.        systems   are  listed  in  the  accompanying  document   RA-
  299.        BETAS.DOC.
  300.  
  301.                                           Andrew Milner.   
  302.                                           Perth, Western Australia.
  303.                                           ─────────────────────────
  304.  
  305.  
  306.                                      2
  307.        OVERVIEW AND FEATURES
  308.        ────────────────────────────────────────────────────────────
  309.  
  310.        RemoteAccess   is  a  "fully-blown"  remote  bulletin  board
  311.        package.  It  may be used as a stand-alone system or with  a
  312.        front-end  mailer  if  you wish to interface it  to  a  mail
  313.        network  such as FidoNet.  It offers fully  definable  menus
  314.        with  a  unique  template system which provides not  only  a
  315.        massive  degree  of  flexibility in  making  your  BBS  look
  316.        different  from  any  other,  but also the  lowest  possible
  317.        maintenance.
  318.  
  319.        Access  to the 200 available message areas is controlled  by
  320.        your  menu structure,  along with a  sophisticated  security
  321.        system which incorporates over 64,000 security levels with a
  322.        set of user-definable flags. For each security level you can
  323.        specify maximum download limits for different log-on speeds,
  324.        daily time limits, and optionally activate the built-in file
  325.        ratio  system,  limiting  downloads by ratio to  uploads  by
  326.        either number of files or kilobytes.
  327.  
  328.        Other security features include the disallowing of downloads
  329.        during peak hours,  disallowing low speed callers at certain
  330.        times,  and disallowing ANSI graphics at low speeds. You can
  331.        disallow  one-word "pseudonyms",  and  optionally  configure
  332.        the system to force a user to change passwords every x  log-
  333.        ons. Undesirable user names and passwords are also definable
  334.        for  maximum  security.  If you're unlikely to want to  call
  335.        your own system, remote sysop access can be disabled, making
  336.        it virtually impossible for your account to be "hacked".
  337.  
  338.        Direct  support  for high-speed modems up to 38,400 baud  is
  339.        available, and RemoteAccess will optionally answer the phone
  340.        automatically  to ensure that the modem will answer if  your
  341.        BBS is "alive and well".
  342.  
  343.        RemoteAccess  supports as many as 99  lines  simultaneously.
  344.        Full  system  access  to  all  file  and  message  areas  is
  345.        available  to  each line (at your discretion),  as  are  all
  346.        doors.  Several  "multi-node specific" features are provided
  347.        to  augment  multi-line operation.  You  can  configure  the
  348.        system  to  disallow one person logging on to more than  one
  349.        line  at  a  time.  A "who else is  on-line?"  and  "today's
  350.        callers" function is available to you,  along with  separate
  351.        system  logs  for each line.  Logging is selectable  between
  352.        either  Opus  or  FrontDoor styles  to  aid  integrated  log
  353.        readability.   Some  basic  user-to-user  on-line messaging,
  354.        to be expanded at a later date, is also available.
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                                      3
  368.        RemoteAccess does NOT do its own internal multi-tasking.  To
  369.        this  end,  we have attempted to make it as well-behaved  as
  370.        possible.  It  has built-in time-slicing and screen-handling
  371.        support  for  DESQview,  TopView,  MultiLink,  DoubleDOS and
  372.        PC-MOS/386. It is  fully overlaid and occupies approximately
  373.        170k of memory when fired up. What do you do if you have say
  374.        a 300k DESQview window and want to run TradeWars in a shell?
  375.        No problem!  Simply by specifying a control character on the
  376.        command line,  you can instruct RemoteAccess to swap  itself
  377.        lock,  stock  and barrel to EMS and/or disk leaving only 20k
  378.        resident. 
  379.  
  380.        A  comprehensive  file transfer system is also part  of  the
  381.        package.  Six  of  the  most  popular  protocols,  including
  382.        Zmodem,  Ymodem batch and Xmodem are built-in,  and  fifteen
  383.        slots  for  external protocols are available for you to  add
  384.        any  others.  The  protocol interface  system  is  extremely
  385.        flexible,  and  has  been tested with DSZ,  Kermit (an  Opus
  386.        compatible protocol),  and BiModem. There are of course many
  387.        others we haven't tested, but most should work.  Support for
  388.        CD-ROM and other mass  read-only media is another invaluable
  389.        feature.
  390.  
  391.        Extensive on-line facilities are available to the sysop.  An
  392.        optional set of status bars provide a wealth of  information
  393.        about  both  the  person currently on-line and  the  system.
  394.        Several  "hot-keys"  are also available to  perform  a  wide
  395.        range  of  functions, amongst  which is  a full  screen user
  396.        attribute editor.
  397.  
  398.        As an added bonus, we have decided to use the QuickBBS-style
  399.        user  and message database formats.  This means that you can
  400.        continue  to use your favourite QuickBBS utilities  with  no
  401.        need to convert to another format.  Any incompatibilities in
  402.        the  configuration  files  is taken care of  by  an  upgrade
  403.        utility.  We  make  no  apology for the  similarity  between
  404.        RemoteAccess and QuickBBS.  QuickBBS had many features  that
  405.        we  wanted,  and  compatibility  gives the  added  bonus  of
  406.        offering  the  sysop  ease  of  installation  and a familiar
  407.        environment.
  408.  
  409.        To  cater for both Opus and QuickBBS users alike,  each user
  410.        has  (at  the discretion of the sysop) the option  of  using
  411.        hot-keyed   menus   or   command   stacking.   Comprehensive
  412.        messaging, file search options and  support for a wide range
  413.        of "doors" ensure that your BBS will be a hit!
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                                      4
  429.        LICENSING INFORMATION
  430.        ────────────────────────────────────────────────────────────
  431.  
  432.        "RA"  refers  to the executable programs  and  documentation
  433.        contained    in   RemoteAccess   Bulletin   Board   Software
  434.        distribution archives released by Continental Software.
  435.  
  436.        1.  RA  is the copyrighted material of Continental Software.
  437.        It  may only be used  in accordance with  the conditions set
  438.        out in this license agreement.
  439.  
  440.        2.  You  may  use RA for a period of three weeks on a  trial
  441.        basis  in  order  to determine  it's  suitability  for  your
  442.        particular application.  After this period you MUST register
  443.        each  copy  of RA that you  run  simultaneously.  Multi-line
  444.        installations  that share  a common file  base AND  have the
  445.        same name need only register one copy.
  446.  
  447.        3.  Registration  entitles  you to  use  RA  and any  future
  448.        versions of  RA  for  as long as you wish,  subject  to  any
  449.        special  licensing conditions  attached to  future versions.
  450.        For  details on  the  registration procedure,  refer to  the
  451.        section in this document "HOW TO REGISTER".
  452.                     
  453.        4.  Continental  Software   is   in  no   way   obligated to
  454.        provide future versions of, or support for, RA.   
  455.  
  456.        5. Site and Group registrations are available, and are dealt
  457.        with on a case by case basis.
  458.  
  459.        6.  You  may  not  modify or otherwise  reverse-engineer RA.
  460.  
  461.        7.  You are encouraged to distribute RA provided that no fee
  462.        is charged  for its distribution, and  that the distribution
  463.        archive  is not  modified  in any  way.  Pay Bulletin  Board
  464.        Systems  may however charge  their  normal fee provided that
  465.        no additional charge for RA is levied.  
  466.  
  467.        8. RA  may not be  included as part of  any software library
  468.        which  is distributed  on a  commercial basis  (commercial =
  469.        "for   money")  without   prior   written  permission   from
  470.        Continental Software.
  471.  
  472.        9. RA may not be used in any unlawful or illegal manner.
  473.  
  474.        10.  Continental  Software's liability  resulting from  your
  475.        use or   inability   to use  RemoteAccess is limited  to the
  476.        amount that  the affected party has  paid for it, or  in the
  477.        event  that RA was registered with a third party for payment
  478.        to Continental Software, liability  is limited to the amount
  479.        that was  received by  Continental Software from  that third
  480.        party.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                                      5
  490.        HOW TO REGISTER
  491.        ────────────────────────────────────────────────────────────
  492.  
  493.        Print  or reproduce the registration form at the end of this
  494.        section and send it with your registration payment to one of
  495.        the following sites:
  496.  
  497.        AUSTRALIA:
  498.  
  499.             "Registration/RA"              "Registration/RA"
  500.             Continental Software           Box 10 
  501.             C/- Milner Intl College        312b North Rocks Rd
  502.             195 Adelaide Terrace           North Rocks  2151
  503.             Perth  6000                    NSW AUSTRALIA
  504.             WESTERN AUSTRALIA
  505.  
  506.        EUROPE:                           USA:
  507.  
  508.             "Registration/RA"              "Registration/RA"
  509.             11 Ernan Road                  C/- Michael F Janke 
  510.             South Ockendon                 8261-B S.W. 107th Ave
  511.             Essex                          Miami FL  33173
  512.             UNITED KINGDOM RM15 5EW
  513.  
  514.        NOTES:
  515.  
  516.        * You MUST fill out the registration form correctly in order
  517.          for your details to be processed. Not doing so will result
  518.          in delays in your key arriving.
  519.  
  520.        * Cheques  and   money   orders  should  be  made  payable  
  521.          to Continental Software UNLESS you are registering in  the
  522.          USA or UK. USA residents should make cheques payable to   
  523.          Michael F Janke; cheques sent to the European (UK)        
  524.          registration site should be made payable to John Barton. 
  525.  
  526.        * Please include either a FidoNet address or a stamped,     
  527.          self-addressed  envelope  so that receipt of your payment 
  528.          can  be acknowledged.
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                                      6
  551.        REGISTRATION FEES:
  552.  
  553.             Noncommercial : $AUD40
  554.             Systems that qualify for this category must be         
  555.             physically run from a noncommercial site. A site is    
  556.             considered to be noncommercial only if it is a private 
  557.             residence at which no commercial activities are        
  558.             conducted.
  559.  
  560.             Commercial/1  : $AUD100
  561.             If the system is physically run from a commercial site 
  562.             (ie. the site is not a private residence, or commercial
  563.             activities are conducted at the site), but does not    
  564.             generate revenue as part of the PRIMARY commercial     
  565.             activities conducted at that site.
  566.  
  567.             Commercial/2  : $AUD350
  568.             If the system generates revenue as part of the         
  569.             primary commercial activities conducted at the system  
  570.             site.
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                      7
  612.                   *** RemoteAccess REGISTRATION FORM ***
  613.  
  614.  
  615.        Sysop Name _________________________________________________
  616.  
  617.        System Name ________________________________________________
  618.  
  619.        [The above two items are used to generate your registration 
  620.         key and must appear EXACTLY as they do in RACONFIG.]
  621.  
  622.  
  623.        Network Address (number and network name) __________________
  624.  
  625.  
  626.        Any other networks you are a member of _____________________
  627.  
  628.  
  629.        Primary BBS telephone number and baud ______________________
  630.  
  631.  
  632.        Hours of BBS operation _____________________________________
  633.  
  634.  
  635.        Postal Address :
  636.  
  637.        ____________________________________________________________
  638.  
  639.        ____________________________________________________________
  640.  
  641.        ____________________________________________________________
  642.  
  643.  
  644.  
  645.        Version of RemoteAccess registering ______.
  646.  
  647.  
  648.        Registration amount enclosed _______, for ____ copies.
  649.  
  650.  
  651.  
  652.        What do you like about RemoteAccess?
  653.  
  654.        ____________________________________________________________
  655.  
  656.        ____________________________________________________________
  657.  
  658.        ____________________________________________________________
  659.  
  660.  
  661.  
  662.        What enhancements/changes would you like to see  in our next
  663.        release?
  664.  
  665.        ____________________________________________________________
  666.  
  667.        ____________________________________________________________
  668.  
  669.  
  670.  
  671.  
  672.                                      8
  673.        The key system
  674.        ────────────────────────────────────────────────────────────
  675.  
  676.        Upon registering you  will receive  your uniquely  generated
  677.        key. Each key is a small file approximately 2k in size which
  678.        contains information about your registration. To install the
  679.        key, simply rename it  (if necessary) to RA.KEY and  copy it
  680.        to your RemoteAccess system directory.
  681.  
  682.        When  RemoteAccess  detects a  valid  key  it switches  into
  683.        registered mode, identifying itself by placing a "+"  at the
  684.        end of the version number as well as displaying the  name of
  685.        the system and  sysop it  is registered to  in the  "version
  686.        information" menu function.
  687.  
  688.        For  example, logging  on to a  registered system  you would
  689.        see:
  690.  
  691.        RemoteAccess 0.03+
  692.        Please enter your full name:
  693.  
  694.        Features marked in this manual with a {+} are only available
  695.        when RemoteAccess  is running in registered  mode. These few
  696.        bonus features show our appreciation of your taking the time
  697.        to register with us.
  698.  
  699.        It  should be  made  absolutely clear  that RemoteAccess  is
  700.        still  fully functional  before  it is  registered; the  few
  701.        bonus features are "nice" but their absence makes the system
  702.        no  less  usable. RemoteAccess  is  not  and  never will  be
  703.        "DemoWare" or "ExpireWare".
  704.  
  705.        WARNING!  Your key  is  unique, and  under NO  circumstances
  706.        should it be  made available to  anyone else. Doing so  is a
  707.        direct violation of the  agreement you entered into with  us
  708.        by registering.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                      9
  734.        PRODUCT SUPPORT                    
  735.        ────────────────────────────────────────────────────────────
  736.  
  737.        You  can always get the latest version of RemoteAccess  from
  738.        the following systems:
  739.  
  740.             Andrew Milner, RemoteAccess HQ West
  741.             +61 9 389 8048 V32/HST
  742.             FidoNet@3:690/625
  743.                 
  744.             Phil Mackay, RemoteAccess HQ East
  745.             +61 2 872 6159 V22bis
  746.             FidoNet@3:711/801
  747.  
  748.             Reinier De Groot, RemoteAccess Help Europe
  749.             +31 1749 48422 HST
  750.             FidoNet@2:2/100
  751.  
  752.             John Barton, RemoteAccess Help UK
  753.             +44 708 852526 HST
  754.             FidoNet@2:2/116
  755.  
  756.  
  757.        There  is  also an echomail  support  conference  available,
  758.        called RA_SUPPORT to answer all of your questions. 
  759.  
  760.        New  releases  and the RA_SUPPORT conference should also  be
  761.        available  from any of the beta test sites,  listed  in  the
  762.        accompanying document RA-BETAS.DOC.
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                     10
  795.        INSTALLATION
  796.        ────────────────────────────────────────────────────────────
  797.  
  798.        RemoteAccess   should  run  on  any  IBM  80x86   compatible
  799.        computer. The only two programs you will need in addition to
  800.        the  release  package are DOS 3.x and a FOSSIL  driver.  The
  801.        FOSSIL is a memory-resident program that many communications
  802.        packages use to communicate with the modem. Two FOSSILs that
  803.        have  been  successfully tested with  RemoteAccess  are  Ray
  804.        Gwinn's X00,  and David Nugent's BNU. Either of these should
  805.        be readily available from any local bulletin board.
  806.  
  807.        You  will  also  need a modem that is capable  of  accepting
  808.        Hayes-type  commands.  The  minimum  memory  requirement  is
  809.        approximately 170K, but 512K is recommended.
  810.  
  811.             1.  Ensure  that  your CONFIG.SYS file  contains  these
  812.                 statements:
  813.  
  814.                 FILES=20
  815.                 BUFFERS=25
  816.                      
  817.                 The   more  buffers  you   allocate,   the   faster
  818.                 RemoteAccess  will run.  However,  more buffers use
  819.                 more memory.
  820.  
  821.             2.  Create  a directory to put the main program  files 
  822.                 in.  The  configuration example that follows  later
  823.                 assumes that this directory (the SYSTEM  directory)
  824.                 is C:\RA.
  825.  
  826.             3.  Ensure  that  your  AUTOEXEC.BAT  file  contains  a
  827.                 command to set the environment variable RA to  your
  828.                 SYSTEM  directory,  so  RemoteAccess can  find  its
  829.                 configuration files:
  830.  
  831.                       SET RA=C:\RA
  832.  
  833.             4.  Copy   all  of  the  executable  files  from  the 
  834.                 RemoteAccess   distribution   package   into   this
  835.                 directory. 
  836.                     
  837.             5.  Create three more sub-directories:
  838.  
  839.                 C:\RA\MSGBASE          This will hold  the  message
  840.                                        files the system creates.
  841.  
  842.                 C:\RA\MENUS            To put your menus in,
  843.  
  844.                 C:\RA\TXTFILES         To put files such as welcome
  845.                                        and disconnect screens in.
  846.  
  847.        You   are   now   ready  to  proceed  to  the   next   step,
  848.        CONFIGURATION.
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                     11
  856.        CONFIGURATION                              
  857.        ────────────────────────────────────────────────────────────
  858.  
  859.        If  you are upgrading your system from a  presently-existing
  860.        QuickBBS  system,  then read the next paragraph.  If  you're
  861.        installing RemoteAccess from scratch then skip the following
  862.        paragraph "QuickBBS to RemoteAccess".
  863.  
  864.  
  865.        QuickBBS  to RemoteAccess                                   
  866.        ────────────────────────────────────────────────────────────
  867.  
  868.        A utility,  called QTORA.EXE has been provided to allow  you
  869.        to convert your existing QuickBBS configuration files to the
  870.        RemoteAccess  format.  Note  that  it will not  modify  your
  871.        existing configuration files in any way.  Copy QTORA to your
  872.        QuickBBS  system directory and run it.  It will  prompt  you
  873.        through  the  whole  conversion process,  and  when  it  has
  874.        finished,  copy  all  the  files  it  has  created  to  your
  875.        RemoteAccess system directory:
  876.  
  877.             COPY *.RA C:\RA
  878.  
  879.        Now,  copy all the *.CTL files to your  RemoteAccess  system
  880.        directory:
  881.  
  882.             COPY *.CTL \RA
  883.  
  884.        The  final  step is to copy all of your BBS system files  to
  885.        the  RemoteAccess  directories.  Copy all the message  files
  886.        (MSG*.BBS)  and the user files (USERS.BBS and  LASTREAD.BBS)
  887.        to the message base directory, and all the other *.BBS files
  888.        to the system directory.
  889.  
  890.        The  conversion process is now complete,  and you can delete
  891.        QTORA.EXE, as it will not be needed for anything else.
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                                     12
  917.        RACONFIG            
  918.        ────────────────────────────────────────────────────────────
  919.  
  920.        Return to the RemoteAccess system directory again,  and fire
  921.        up  the configuration utility,  RACONFIG.EXE.  You will  use
  922.        this to choose the configuration options for your particular
  923.        system.  You will see that there are six options in the menu
  924.        bar. Here is a walk-through of the various options.
  925.  
  926.  
  927.  
  928.        Select  the  MODEM  option,  and  then  SETUP.  This  window
  929.        contains  general configuration information for your  modem.
  930.  
  931.        The  first  item  is the COMPORT setting.  Set this  to  the
  932.        communications port you have your modem hooked up to.  Valid
  933.        ports  are 1-4.  MAXIMUM BAUD refers to the  highest  modem-
  934.        computer speed your modem supports. If you are using a high-
  935.        speed modem you should lock the speed at the modem's maximum
  936.        speed  to ensure the highest possible throughput.  Refer  to
  937.        your FOSSIL documentation on how to do this.
  938.  
  939.        The  INITIALISATION  RESPONSE is the string that  the  modem
  940.        returns  after  RemoteAccess  sends  it  the  initialisation
  941.        string.  Most  modems  return "OK".  Likewise for  the  BUSY
  942.        RESPONSE, most modems also return "OK".
  943.  
  944.        The  RING  STRING  is  the string the  modem  displays  when
  945.        someone calls your system,  to indicate that the call should
  946.        be answered.  Most modems return "RING", some use "RINGING".
  947.        Check your modem manual and set this accordingly.
  948.  
  949.        CONNECT 300 - CONNECT 38k are the response strings the modem
  950.        returns when a connection is made with another  modem.  Most
  951.        modems  return  a  "CONNECT <Baudrate>"  string,  or  simply
  952.        "CONNECT"  for 300 baud.  Note that if this is the case  you
  953.        should specify the vertical bar after the string to indicate
  954.        the end of the string.  (See MODEM STRING TRANSLATION in the
  955.        reference guide at the end of this document).
  956.  
  957.        AUTOMATIC ANSWER.  Setting this to "Yes" tells  RemoteAccess
  958.        to  make the modem answer the phone whenever it receives the
  959.        ring string by sending the answer command to the modem  (see
  960.        INITIALISATION).  If  it  is set to "No" then it is  assumed
  961.        that  the modem will answer the phone itself.  "Yes" is  the
  962.        preferred  setting,  as it ensures that your BBS  will  only
  963.        answer the phone if it is "alive and well".  Otherwise,  you
  964.        are likely to upset your users when they  waste their  money
  965.        on a BBS that answers the phone and then does nothing.
  966.  
  967.        MODEM  DELAY refers to a delay,  in tenths of a second  that
  968.        RemoteAccess  waits between sending characters to the  modem
  969.        during initialisation.  Usually you will only need to  raise
  970.        this  above  zero if you are using a high-speed  modem  that
  971.        cannot handle commands at high speeds.  A typical example of
  972.        this is the Courier HST, which requires a delay of about 3.
  973.  
  974.  
  975.  
  976.  
  977.                                     13
  978.        The   OUTBOUND   BUFFER   SIZE  field  sets  the   size   of
  979.        RemoteAccess'  internal communications send buffer for  baud
  980.        rates up to 2400. You can change it to fine-tune your system
  981.        for maximum throughput. If you are using a slow machine (ie.
  982.        a 4.77 MHz XT),  set it to zero.  This disables the internal
  983.        buffering  system  and its  associated  overhead.  For  most
  984.        systems,  the  default  setting  of 5 will not  need  to  be
  985.        changed.  In  a multi-tasking environment though,  you  will
  986.        achieve  much  better performance by increasing  the  buffer
  987.        size.  Experimentation  has shown values around 80-150 to be
  988.        most effective.
  989.  
  990.  
  991.  
  992.        Now select the MODEM INITIALISATION  option.  INITIALISATION
  993.        TRIES  is  the number of times RemoteAccess will attempt  to
  994.        initialise the modem before aborting and returning an  error
  995.        condition.
  996.  
  997.  
  998.        The  INITIALISATION  STRING  is sent to the  modem  whenever
  999.        RemoteAccess  is fired up.  This string should  prepare  the
  1000.        modem to take calls.  See the reference section MODEM STRING
  1001.        TRANSLATION   at   the  end  of  this  document   for   more
  1002.        information.
  1003.  
  1004.  
  1005.        The  BUSY  STRING is sent to the modem whenever  you  either
  1006.        log-on  locally  or if you ESCape from the "wait  for  call"
  1007.        sequence.  You  could either tell the modem to go "off hook"
  1008.        with  an  "ATH1|",  or  simply not to answer  the  phone  by
  1009.        dropping DTR.
  1010.  
  1011.        The  ANSWER  STRING  is sent to the modem if  you  have  set
  1012.        automatic answer on,  and a call comes in.  Most modems will
  1013.        answer a call upon receiving an "ATA|" from the computer.
  1014.  
  1015.  
  1016.  
  1017.        Next select MODEM ERRORLEVELS.  These values are used if you
  1018.        have  activated  the "Shell to  Mailer"  feature.  For  full
  1019.        information  on this option,  read the reference section  on
  1020.        COMMAND LINE PARAMETERS.
  1021.  
  1022.  
  1023.  
  1024.        Select the MODEM RESTRICTIONS option. MINIMUM BAUD FOR LOGON
  1025.        allows  you to set the lowest baud rate for a user to log on
  1026.        to your system. Calls at 300 baud may be restricted by using
  1027.        the  NO 300 START and NO 300 END options.  To  disable  this
  1028.        option, set both start and end times to 00:00.
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.                                     14
  1039.        You can also limit file downloads in the same way.  However,
  1040.        this  option differs slightly in that the MINIMUM  BAUD  FOR
  1041.        FILE TRANSFERS applies all the time.  The DOWNLOAD START/END
  1042.        times  specify times during which downloads may occur.  Note
  1043.        that  this  time  restriction may be cancelled  for  certain
  1044.        users  by  setting  a flag in their  user  record.  See  the
  1045.        section on USERS for more on this.
  1046.  
  1047.  
  1048.  
  1049.  
  1050.        This  completes the MODEM configuration option.  Now  select
  1051.        MISC  from  the menu bar,  and then  PATHS.  Here  you  tell
  1052.        RemoteAccess where all its associated files are stored.  The
  1053.        directories  are  the same as the ones discussed earlier  in
  1054.        the installation example.  Enter the full directory paths to
  1055.        your chosen directories. The trailing backslash is optional.
  1056.        See the section on MAIL NETWORKING for details on how to set
  1057.        up the NODELIST path.
  1058.  
  1059.  
  1060.  
  1061.        Select the MISC ADDRESS option.  If you do not intend to use
  1062.        your BBS in a mail network (eg. FidoNet, AlterNet) then skip
  1063.        this  section.  Select MAIN ADDRESS and enter  your  network
  1064.        address. If you have any alias addresses (AKAs), enter these
  1065.        in  one  or  more  of the nine  slots  provided.  For  extra
  1066.        information  on  network  operation and  an  explanation  of
  1067.        addresses, see the section on MAIL NETWORKING.
  1068.  
  1069.  
  1070.        Now  select the MISC SECURITY option.  NEW USER SECURITY  is
  1071.        the  security level (0 to 64,000) that will be granted to  a
  1072.        new  user  who  logs on for the first time.  If  you  run  a
  1073.        private  system,  and do not want to allow new users to  log
  1074.        on,  set  this  field to zero.  In this case,  the  user  is
  1075.        notified that the system is private and is disconnected. 
  1076.        NEW  USER  FLAG SETTINGS is the security flag  setting  that
  1077.        will be granted to the new user. See the section on SECURITY
  1078.        for a full description of the RemoteAccess security system. 
  1079.        CRASHMAIL  and  FILE ATTACH security is related  to  sending
  1080.        private messages to other systems if you are part of a  mail
  1081.        network.  See  the  section  on  MAIL  NETWORKING  for  more
  1082.        information on this.
  1083.  
  1084.  
  1085.  
  1086.        Select  MISC PROTOCOLS.  This option allows you to interface
  1087.        up to fifteen external protocols for your users to  use,  in
  1088.        addition  to the six that are built-in.  When a user selects
  1089.        to  upload or download a file,  he/she is presented  with  a
  1090.        hard-coded   menu   that  lists  the  available   protocols,
  1091.        including  your  external  ones.   The  NAME  field  is  the
  1092.        protocol  name that the user sees in this menu.  The KEY  is
  1093.        the  keypress that should activate the protocol.  Note  that
  1094.        the KEY must be unique. In other words, since [Z]modem is an
  1095.        internal protocol, you can't use [Z] to activate an external
  1096.        protocol.
  1097.  
  1098.  
  1099.                                     15
  1100.        Before  RemoteAccess  activates the  external  protocol,  it
  1101.        creates  a control file that tells the protocol which  files
  1102.        to  send  or receive.  This file consists  of  some  general
  1103.        information  and  a list of files,  one per  line.  You  may
  1104.        define  exactly  what each line looks like.  If  you  select
  1105.        EXTENDED  CONTROL  FILE,  then RemoteAccess will  write  the
  1106.        information  needed by Opus-compatible external protocols at
  1107.        the  beginning of the file  before the file  list. Check the
  1108.        documentation  for each  protocol you  install to  determine
  1109.        whether it is "Opus compatible".
  1110.  
  1111.        If  the protocol has the capability to send or receive  more
  1112.        than one file at a time, set BATCH AVAILABLE to "Yes".
  1113.  
  1114.        You may temporarily disable the current protocol by  setting
  1115.        its  status to DISABLED,  re-enabling it later by setting it
  1116.        to ENABLED.
  1117.  
  1118.        The LOG FILE NAME is the full path and name of the log  file
  1119.        that  the  external  protocol  writes.  This  file  contains
  1120.        information about what files were actually sent or received.
  1121.        Without  this information,  RemoteAccess will not be able to
  1122.        update the  user's record. Most protocols  have the facility
  1123.        to  create a  log of  the files that  were actually  sent or
  1124.        received; if the protocol you are installing doesn't, it  is
  1125.        advisable not to use it.
  1126.  
  1127.        The  CONTROL  FILE  NAME is the full path and  name  of  the
  1128.        control file that RemoteAccess creates before activating the
  1129.        protocol.  In  order to allow the use of as  many  different
  1130.        protocols as possible, you have full control over the format
  1131.        of  this file.  The DOWNLOAD CONTROL STRING determaines  the
  1132.        format  of  each file entry.  Inserting a "@" in the  string
  1133.        substitutes that position with the file name.  For  example,
  1134.        if      you     wanted     to     download     the      file
  1135.        C:\FILES\IBM\FUN\CASINO.ZIP  using  an  Opus  type  external
  1136.        protocol, you would set the control file string to:
  1137.  
  1138.             Send @
  1139.  
  1140.        When the control file is created, this would be expanded to:
  1141.  
  1142.             Send C:\FILES\IBM\FUN\CASINO.ZIP
  1143.  
  1144.        If  the user were to select a batch download,  say  RA*.ZIP,
  1145.        the  wildcard/pattern  match is expanded to a full  list  of
  1146.        fully qualified path and file names.
  1147.  
  1148.        The  UPLOAD  CONTROL STRING works in exactly the  same  way,
  1149.        except  that  for batch uploads,  instead of specifying  the
  1150.        full file name,  it substitutes just the path to the  upload
  1151.        directory,  as  the  filenames  are not known prior  to  the
  1152.        upload.
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.                                     16
  1161.        UPLOAD/DOWNLOAD COMMAND LINE tells RemoteAccess what program
  1162.        name to execute in order to activate the external  protocol.
  1163.        It  is  possible to insert variables into the  command  line
  1164.        using special control characters. For example, the string:
  1165.  
  1166.             PROTNAME.EXE Send *B
  1167.  
  1168.        would be expanded to:
  1169.  
  1170.             PROTNAME.EXE Send 2400
  1171.  
  1172.        For  a  full  list of special control codes,  refer  to  the
  1173.        description  of a Type 7 menu command in the  MENU  COMMANDS
  1174.        section.  In  addition to these codes,  the # symbol can  be
  1175.        used  if  the  filename  to  send or  receive  needs  to  be
  1176.        specified on the command line.
  1177.  
  1178.        When  the  external  protocol has finished  and  control  is
  1179.        returned  to RemoteAccess,  the log file that was created is
  1180.        scanned to extract information about what files were sent or
  1181.        received.  RemoteAccess  scans  the file for the  UPLOAD  or
  1182.        DOWNLOAD LOG KEYWORD. As soon as it finds that word, it will
  1183.        scan  forward x number of words to get the name of the  file
  1184.        transferred and a description,  if available.  To illustrate
  1185.        how this works, look at this extract from a BiModem log:
  1186.  
  1187.        = 10 Sep 14:10:10 BMOD DL-B \GRAPHICS\FORMATS\LOCKLEAR.ZIP
  1188.        = 10 Sep 14:12:22 BMOD DL-B \GRAPHICS\FORMATS\AWESOME.ZIP
  1189.  
  1190.        The  DOWNLOAD  LOG KEYWORD can be any word in the  log  file
  1191.        that  indicates the transfer of a single file.  The  keyword
  1192.        would  be  set  to "DL-B",  and the NAME WORD #  set  to  1.
  1193.        RemoteAccess  scans the above entries until it hits  "DL-B",
  1194.        and then counts forward 1 word to get the file name. Uploads
  1195.        work in the same way, but a description word number may also
  1196.        be specified,  as some protocols get file descriptions  from
  1197.        the user directly. If RemoteAccess finds a description it is
  1198.        appended  to  the end of the FILES.BBS file,  otherwise  the
  1199.        user is prompted for the description.
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.                                     17
  1222.        Example : Installing Lynx as an external protocol
  1223.        -------------------------------------------------
  1224.  
  1225.        Select  an  empty  protocol slot,  and enter  the  following
  1226.        information:
  1227.  
  1228.        Name                  : Lynx
  1229.        Key                   : L
  1230.        Extended control file : No
  1231.        Batch available       : Yes
  1232.        Status                : Enabled
  1233.        Log file name         : C:\Ra\Dszlog.Txt
  1234.        Control file name     : C:\Ra\Lynx.Ctl
  1235.        Download command line : Lynx.Exe S /*P /*B /S /H @Lynx.Ctl
  1236.        Upload command line   : Lynx.Exe R /*P /*B /S /D /H #
  1237.        Download ctl string   : @
  1238.        Upload ctl string     :
  1239.        Download log keyword  : x
  1240.        Upload log keyword    : X
  1241.        Log : Name word #     : 10
  1242.        Log : Desc word #     : 0
  1243.  
  1244.        (Note  the  case  of  the upload and  download  log  keyword
  1245.        entries).
  1246.  
  1247.        The  above  example assumes that your  system  directory  is
  1248.        C:\RA.  To complete the installation, you'll need to set the
  1249.        DSZLOG environment variable to the full path and name of the
  1250.        log file that Lynx writes:
  1251.  
  1252.             SET DSZLOG=C:\Ra\Dszlog.Txt
  1253.  
  1254.  
  1255.        Select the MISC COLOURS option.
  1256.  
  1257.        This  menu  allows you to choose the  various  colours  that
  1258.        RemoteAccess  uses.  Use  either the  default  settings,  or
  1259.        select your own.
  1260.  
  1261.  
  1262.        Select the MISC GENERAL option,  and then select USERS.  The
  1263.        ANSI  GRAPHICS setting will determine whether the user  will
  1264.        be  allowed to use or not use ANSI graphics.  If this is set
  1265.        to "No",  only plain ASCII files will be displayed.  A "Yes"
  1266.        entry will force ANSI graphics on,  and "Ask" will give  the
  1267.        user  the  option of either ANSI or plain ASCII when  he/she
  1268.        logs on.  This format is the same for CLEAR SCREEN and  MORE
  1269.        PROMPTING.
  1270.  
  1271.        If  ASK FOR BUSINESS/DATA PHONE NUMBER is set to "Yes",  new
  1272.        users will be asked for this number.  RemoteAccess accepts a
  1273.        wide range of phone number formats, but attempts to disallow
  1274.        obvious "fakes".  ASK FOR HOME/VOICE NUMBER operates in  the
  1275.        same way.
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.                                     18
  1283.        If  you  set ALLOW ONE WORD NAMES to "No" then  RemoteAccess
  1284.        will "insist" on a full name of at least two words when each
  1285.        user logs on.  Otherwise,  no checking will be performed  on
  1286.        user names.
  1287.  
  1288.        NUMBER  OF TIMES TO TRY FOR PASSWORD sets the maximum number
  1289.        of  invalid password attempts.  After this is  exceeded  the
  1290.        user will be disconnected.
  1291.  
  1292.        LOGONS  BEFORE  FORCED PASSWORD CHANGE is  another  security
  1293.        feature.  If  this  is set to any non-zero value,  then  all
  1294.        users  (excluding the sysop) will be forced to change  their
  1295.        password every number of logons as determined by its value.
  1296.  
  1297.        TIME  LIMIT  FOR LOG-ON PERIOD specifies how  much  time  to
  1298.        grant to a user before the system knows how much time he/she
  1299.        is entitled to. You should make this long enough to enable a
  1300.        new   user   to   complete  the  new  user   procedure   and
  1301.        questionnaire, if you have one.
  1302.  
  1303.        MAXIMUM  USER INACTIVITY PERIOD determines how long to  wait
  1304.        during  periods  of  inactivity  before  disconnecting.  The
  1305.        inactive  time  period is measured from the  last  character
  1306.        sent to the modem. This feature is automatically disabled in
  1307.        local mode, or by a setting of zero.
  1308.  
  1309.        ALLOW  USERS  TO  UPLOAD MESSAGES.  When this option  is set
  1310.        to "Yes", when users enter a message they are  asked if they
  1311.        wish to "upload a prepared message?" This allows the user to
  1312.        prepare  his/her messages offline and send them using any of
  1313.        the  available  file  transfer  protocols.  Note  that  ONLY
  1314.        internal protocols may be used as RemoteAccess does not have
  1315.        enough control over the external ones. The maximum size of a
  1316.        message that may be uploaded is pre-set at 20k.
  1317.  
  1318.        The  KILL MESSAGES AFTER SENT option applies to NetMail sent
  1319.        through a mail network.  When the message is entered, if set
  1320.        to  "Ask",  it will ask the user whether to  delete  his/her
  1321.        message   after  it  has  been  exported  from  the  message
  1322.        database.
  1323.  
  1324.        STRICT  PASSWORD CHECKING is an invaluable security  feature
  1325.        which if enabled, will check passwords that users enter. You
  1326.        can specify certain undesirable passwords in a control  file
  1327.        (see  the  section on EXTERNAL FILES),  such as "Secret"  or
  1328.        "Test".  It will also disallow the user's first or last name
  1329.        as  a  password,  and checks the old and new  passwords  for
  1330.        phonetic similarity.
  1331.  
  1332.        You may also specify the minimum password length that  users
  1333.        may select.  Longer passwords mean better security,  a value
  1334.        of 4 is recommended as an absolute minimum.
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.                                     19
  1344.        RemoteAccess   may  be  configured  to  behave  either  like
  1345.        QuickBBS  with hot-keyed menus,  or like Opus  with  command
  1346.        stacking  facilities.  If the USE HOT-KEYS option is set  to
  1347.        "Yes", the system defaults to hot keys for each new user. If
  1348.        the  option  is set to "Ask" then each new user is asked  to
  1349.        choose  between hot keys or command stacking.  The user  may
  1350.        change his or her choice by selecting the toggle hotkey menu
  1351.        command (see the section on MENU FUNCTIONS).
  1352.  
  1353.        If a user logs on and is disconnected because he/she  enters
  1354.        his  or her password  incorrectly,  RemoteAccess can  notify
  1355.        that user of a possible attempt at guessing the password, by
  1356.        way of a private message.  In the SECURITY WATCHDOG  MESSAGE
  1357.        AREA  field,  specify  the message area number (as per  your
  1358.        message area configuration) that the warning message  should
  1359.        be  placed  in.  A value of zero disables this  feature.  In
  1360.        addition,  you will need to create an ASCII text file called
  1361.        WATCHDOG.MSG in the system directory that contains the  text
  1362.        of the message that is sent to the user.
  1363.  
  1364.  
  1365.        Select GENERAL PAGING.  PAGE LENGTH specifies the number  of
  1366.        seconds  to sound the bell at the local console when a  user
  1367.        pages you for a chat.  MAXIMUM PAGES allows you to limit the
  1368.        number of times a user may page you during one session.  You
  1369.        may  also  specify paging "hours" using the PAGING START/END
  1370.        TIME  option.  If either field is set to a  non-zero  value,
  1371.        users will only be allowed to page you between these hours.
  1372.  
  1373.  
  1374.        Now go to GENERAL SCREEN. You can force the system to run in
  1375.        Monochrome  Mode by setting MONOCHROME to "Yes".  If you are
  1376.        not using RemoteAccess in a multi-tasking environment,  then
  1377.        set DIRECT WRITE MODE to "Yes".  This will cause all  screen
  1378.        output  to be written directly to Video RAM instead of using
  1379.        BIOS calls, and will result in a significant speed increase.
  1380.  
  1381.        If  you  use  one of the older CGA cards that  is  prone  to
  1382.        "snowing", set SNOW CHECK to "Yes".
  1383.  
  1384.  
  1385.        GENERAL  SYSTEM is the next option in the MISC  menu.  Enter
  1386.        the name of your BBS in the SYSTEM NAME field,  and your own
  1387.        name in the SYSOPS NAME field.  The LOADING MESSAGE field is
  1388.        displayed to a caller whenever RemoteAccess exits to a batch
  1389.        file  or  runs a door in a shell.  Put something  like  "One
  1390.        moment please .." in here.
  1391.  
  1392.        LIST  PROMPT  is displayed at the bottom of a  type  6  menu
  1393.        command. See the MENU COMMANDS section for more information.
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.                                     20
  1405.        The  QUOTE STRING is a highlight character that RemoteAccess
  1406.        will place in front of any message that is replied  to.  For
  1407.        example,  a  message quoted using " > " as the quoter  would
  1408.        look like:
  1409.  
  1410.               > I have been using RemoteAccess for 2 months now and
  1411.               > love it!
  1412.                          
  1413.             I have to agree with you there,  Tom.  Flexibility-wise
  1414.            you just can't beat it.
  1415.  
  1416.        A  '@' character in the quote string will be translated into
  1417.        the initials of the person whose message is being quoted.
  1418.  
  1419.        The  UPLOAD  CREDIT FACTOR provides a way of rewarding  your
  1420.        users for uploading files to you.  If this value is set to a
  1421.        non-zero  value,  after  each upload session,  the  user  is
  1422.        granted that many seconds per minute of upload time.  So, if
  1423.        you set the credit factor to 30 (seconds), and a user spends
  1424.        10  minutes uploading,  he/she would be granted an  extra  5
  1425.        minutes for that session. Note that during uploads the timer
  1426.        is "frozen" in addition to this bonus.
  1427.  
  1428.        If  you  set  ALLOW  FAST LOGONS  to  "Yes",  then  whenever
  1429.        RemoteAccess is activated in local mode, it will assume that
  1430.        it  is  the sysop who is logging on,  and  will  prompt  for
  1431.        password only.
  1432.  
  1433.        If you are running more than one line,  you should set CHECK
  1434.        FOR  MULTI-LOGON  to "Yes".  This will prevent a  user  from
  1435.        logging  on  to  more than one line at the  same  time,  and
  1436.        effectively  using his/her entire daily time limit  on  EACH
  1437.        LINE.
  1438.  
  1439.        If  you  never (or rarely) call your own BBS  remotely,  you
  1440.        should  disallow sysop remote access by setting ALLOW  SYSOP
  1441.        REMOTELY  to "No".  This makes it almost impossible  for  an
  1442.        unknown  "hacker" to gain access to your system via your own
  1443.        account.
  1444.  
  1445.        EXCLUDE  SYSOP FROM LIST,  if set to "Yes",  will cause  the
  1446.        sysops name to be ommitted from a User List, List of Today's
  1447.        Callers,  Who Else Is Online, and the Last Caller functions.
  1448.        Useful if you don't want a user to know you're there!
  1449.  
  1450.        CHECK  FOR  MAIL AT LOG-ON,  when enabled,  will  force  the
  1451.        system  to scan the message-base for new mail  addressed  to
  1452.        the  user  (regardless of what area it is in,  provided  the
  1453.        user has access to that area) at log-on.
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.                                     21
  1466.        The FULL MAIL CHECK option determines the type of mail check
  1467.        that is performed.  A full check scans from the start to the
  1468.        end  of the message-base for all mail addressed to the  user
  1469.        that does not have the "Received" flag set.  If you set  the
  1470.        option  to "Off",  the message base is only checked from the
  1471.        last message that the user read.  While this is much faster,
  1472.        there  is the possibility that some mail may be  skipped  if
  1473.        the  user  elected not to read his/her mail during the  last
  1474.        logon.
  1475.  
  1476.        When a user gets a list of files in a file area,  the format
  1477.        of  a  file  entry  is  the  file  name,  length,  date  and
  1478.        description. It is possible to omit the date from each line,
  1479.        thus making it possible to have more verbose descriptions by
  1480.        setting SHOW FILE DATES to "No". 
  1481.  
  1482.        Note that the asterisk normally displayed immediately  after
  1483.        the date which indicates the file is new since the last log-
  1484.        on is still displayed.
  1485.                     
  1486.        When  a  file  is uploaded using a batch  protocol  such  as
  1487.        Zmodem, or Ymodem, the original date of the file is normally
  1488.        preserved when the file is saved in the upload area. This is
  1489.        of little use if the file was originally created in 1987, so
  1490.        RemoteAccess will,  if the RESET UPLOAD FILE DATES option is
  1491.        enabled,  reset  the  date stamp of the file to the date  on
  1492.        which it was uploaded.
  1493.  
  1494.        By  inserting  a special control code in a text file  it  is
  1495.        possible to automatically activate a program in a shell when
  1496.        the  text file is displayed.  As explained in the TEXT  FILE
  1497.        CONTROL   CODES  section,   there  are  important   security
  1498.        considerations that must be looked into if you intend to use
  1499.        this feature. If you aren't going to use it, set SHELLS FROM
  1500.        TEXT FILES to "No".
  1501.  
  1502.        The  next  option in the SYSTEM menu is the SYSTEM LOG  FILE
  1503.        NAME.  RemoteAccess  logs all user activity in detail  to  a
  1504.        human-readable  text file.  Set the name of the log file  to
  1505.        point to your system directory, for example C:\RA\RA.LOG.
  1506.  
  1507.        Next,  select  the logging format that most suits you;  Opus
  1508.        mode contains more information, including the line number in
  1509.        a  multi-line  system.  The FrontDoor format  is  much  more
  1510.        compact.
  1511.  
  1512.        It  is  possible to disable uploads when the amount of  free
  1513.        space on your upload drive falls below a preset  level.  For
  1514.        example, to disable uploads if there is less than 1 megabyte
  1515.        free, set MINIMUM UPLOAD SPACE to 1000 (kilobytes).
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.                                     22
  1527.        If you are installing RemoteAccess on a multi-line site (ie.
  1528.        you  are going to be running more than one line),  you  MUST
  1529.        set  the  MULTI  LINE  option  to "Yes".  This enables extra
  1530.        file/message  checking  routines to ensure that  a  conflict
  1531.        between  two lines accessing the same data never arises.  If
  1532.        you are running only one line,  setting this option to "Off"
  1533.        will  disable this checking and significantly increases  the
  1534.        system's operating speed.
  1535.  
  1536.        The  ENVIRONMENT option refers to the type of  multi-tasking
  1537.        system  that you will be running RemoteAccess under.  If set
  1538.        to "Auto-detect", RemoteAccess will attempt to determine the
  1539.        multitasker   in   use   when   it   fires   up.   On   some
  1540.        hardware/software  configurations  it  may not  be  able  to
  1541.        correctly detect it's environment. To overcome this, you can
  1542.        force  RemoteAccess to "assume" that it is running  under  a
  1543.        specific  multitasker.  Environments currently supported are
  1544.        DoubleDOS,  DESQview, TopView, MultiLink, PC-MOS/386 and the
  1545.        "standard" AT BIOS. RemoteAccess will time-slice, or give up
  1546.        CPU time, to other tasks when it is waiting for a call or at
  1547.        a  prompt.  The  result  is  a  significant  overall  system
  1548.        performance improvement.
  1549.  
  1550.  
  1551.        The last option in the MISC menu is ALT-FKEYS.  When one  of
  1552.        the  ten  function  keys  on your  keyboard  is  pressed  in
  1553.        conjunction  with the ALT key,  RemoteAccess will do one  of
  1554.        three  things : If the command string that you have assigned
  1555.        to  the   function key  that  is pressed  is a  standard DOS
  1556.        command  line,   then   that   line  will  be executed  in a
  1557.        shell  while RemoteAccess  remains in memory.   If,  on  the
  1558.        other hand, the first   character of the command  string for
  1559.        the  function  key  is the  query symbol  (?) followed  by a
  1560.        number,  RemoteAccess  will exit to  DOS with an  errorlevel
  1561.        equal to  the number. Alternatively, if  the first character
  1562.        of the  command string  is the  hash (#),  RemoteAccess will
  1563.        display the named text file from the textfile directory. For
  1564.        example, suppose three entries looked like this:
  1565.  
  1566.             5 : ?110
  1567.             6 : C:\COMMAND.COM
  1568.             7 : #WELCOME
  1569.  
  1570.        Pressing ALT-F5 would cause RemoteAccess to exit to DOS with
  1571.        an   errorlevel  of  110, ALT-F6  would execute a  copy   of
  1572.        COMMAND.COM  in  a  shell,  and  ALT-F7  would  display  the
  1573.        appropriate (ASC/ANS)  version of  your WELCOME.A?? file  to
  1574.        the user.
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.                                     23
  1588.        Events             
  1589.        ────────────────────────────────────────────────────────────
  1590.  
  1591.        The  RemoteAccess  Event  Editor  allows  you  to  set  pre-
  1592.        determined  times  during  the week when  RemoteAccess  will
  1593.        automatically  exit to your batch file and  perform  certain
  1594.        functions,  usually some kind of system maintenance.  Select
  1595.        EVENTS  from  the main menu bar.  This window  contains  all
  1596.        event information.  You may define up to 20 events to run at
  1597.        any  time during the day.  In addition to this,  it is  also
  1598.        possible  to specify that an event only run on a  particular
  1599.        day or days of the week.
  1600.  
  1601.        To  modify  an event,  simply move the highlight bar to  the
  1602.        event you wish to alter, and press [CR]. Use the cursor keys
  1603.        to move between entries in the event edit window,  and enter
  1604.        the time you want the event to start at,  in 24 hour format.
  1605.  
  1606.        Next,  enter  the errorlevel;  when the event is  activated,
  1607.        RemoteAccess  will exit to the batch file from which it  was
  1608.        called at this errorlevel.  Your batch file should trap this
  1609.        errorlevel and act accordingly. In this window, you can also
  1610.        specify  what days you would like the event to run  on,  and
  1611.        whether the event is enabled or disabled.  More  information
  1612.        on events is contained in the BATCH FILE EXAMPLES section.
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.                                     24
  1649.        Files                       
  1650.        ────────────────────────────────────────────────────────────
  1651.                     
  1652.        Select  FILES  from  the main menu bar.  This is  where  you
  1653.        define your file areas.  Note that this data is optional. It
  1654.        is  only needed if you intend to either use any of the  file
  1655.        scan  menu  functions,  or activate the file  area  template
  1656.        system. 
  1657.  
  1658.        Usually your file areas will be grouped by area of interest.
  1659.        For  example, file area 1  might be "DOS  utilities", area 2
  1660.        "Pascal programming files", area 3 "Graphics picture files",
  1661.        and so on.
  1662.  
  1663.        Most  of the entries here are  fairly  straightforward.  The
  1664.        FILE AREA NAME is the name of the file area as the user will
  1665.        see  it.  The FILE PATH is a fully qualified directory  path
  1666.        that points to where the files in this area are stored,  for
  1667.        example   C:\FILES\IBM\GAMES\.   Note   that  the   trailing
  1668.        backslash is optional.
  1669.  
  1670.        The list of files that your users see  for a particular area
  1671.        is  generated from a textfile that you can edit yourself. By
  1672.        default, this file is called FILES.BBS and is located in the
  1673.        same directory as  the files  it describes. When  a file  is
  1674.        uploaded  to  a  file   area,  RemoteAccess  creates  a  new
  1675.        FILES.BBS if  it doesn't already  exist, and then  appends a
  1676.        single line entry for  the file. The format of  FILES.BBS is
  1677.        simple:
  1678.  
  1679.        <FILENAME.EXT> <Description>
  1680.  
  1681.        Filenames that contain wildcard  / pattern match  characters
  1682.        are  expanded to  full filename specs.  A separate  entry is
  1683.        displayed for each matching file found.
  1684.  
  1685.        The <Description> field  may be up  to 255 characters  long.
  1686.        When displayed to the  user the description is automatically
  1687.        word wrapped to the width of the user's screen.
  1688.  
  1689.        By  entering a  full path and  name in the  LIST PATH field,
  1690.        RemoteAccess can be forced to read another text file instead
  1691.        of  FILES.BBS.  This  is  an extremely  useful  feature  for
  1692.        systems  that use one or more CD-ROMs, which don't allow the
  1693.        FILES.BBS to be placed  in the same directory as  the actual
  1694.        files themselves.
  1695.  
  1696.        Access  to  each  file area is  controlled  by  raising  the
  1697.        SECURITY LEVEL and FLAGS to the minimum combination required
  1698.        for  a user to "see" the area.  For example,  if a user uses
  1699.        the  "Search  for new files" function,  only file  areas  to
  1700.        which he/she has the required security/flags setting will be
  1701.        checked.
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.                                     25
  1710.        Message areas                         
  1711.        ────────────────────────────────────────────────────────────
  1712.  
  1713.        The  last configuration section is the message  areas.  From
  1714.        the MESSAGES menu,  select MESSAGE BOARDS. You may define up
  1715.        to  200 different areas,  each with it's own attributes  and
  1716.        security requirements.
  1717.  
  1718.        Firstly,  give the area a name.  This should be a meaningful
  1719.        description  of  its  content,   for  example  "IBM  Users",
  1720.        "Cooking",   or  "Entertainment".  Avoid  using  names  like
  1721.        "Message Area 1".  If you wish to "delete" the message area,
  1722.        simply set the area name to nothing.
  1723.  
  1724.        Each area can be one of three TYPES.  LOCAL,  if the message
  1725.        area is available on your BBS only,  or if you are in a mail
  1726.        network such as FidoNet,  ECHOMAIL or NETMAIL.  These latter
  1727.        two  types  are explained more fully in the MAIL  NETWORKING
  1728.        section. If you are not part of a mail network, set the type
  1729.        to LOCAL.
  1730.  
  1731.        MESSAGE STATUS controls the types of messages that users are
  1732.        allowed to post in the area.  You have the choice of PRIVATE
  1733.        ONLY,  PUBLIC ONLY,  PRIVATE/PUBLIC and READ ONLY. It may be
  1734.        desirable   to  allow  only  public  messages   in   general
  1735.        discussion  areas,  or likewise private only in user-to-user
  1736.        message  areas to ensure that all messages in that area  may
  1737.        be read only by the sender or the recipient of the  message.
  1738.        Message  areas  marked as READ ONLY may only  have  messages
  1739.        posted  in  them by the sysop.  This is useful  for,  say  a
  1740.        general announcement area.
  1741.  
  1742.        In  certain  areas  you  may wish to  allow  users  to  post
  1743.        messages using an alias, or "pseudonym".  If so, set ALIASES
  1744.        ALLOWED to "Yes".  Entering a message in one of these areas,
  1745.        the  user  is prompted for an alias with which to  post  the
  1746.        message.  RemoteAccess will not allow the user to use either
  1747.        any other user's name or "Sysop" as an alias.
  1748.  
  1749.        The  next three options are used by RAMSG,  the message-base
  1750.        maintenance  utility.  In  order to keep the  size  of  your
  1751.        message-base   files  down  to  a  reasonable  level  it  is
  1752.        necessary to regularly delete "old" messages. You should set
  1753.        these  options according to the requirements of  each  area.
  1754.  
  1755.        For  further details,  see  the section  on maintaining  the
  1756.        message database files.
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.                                     26
  1771.        For  example,  if the area is high-traffic,  by setting DAYS
  1772.        UNTIL  OLD MESSAGES ARE KILLED to 7,  RAMSG will delete  any
  1773.        message  in that area that is over a week old.  You can  use
  1774.        these  options  in combination.  By setting DAYS  UNTIL  OLD
  1775.        MESSAGES ARE KILLED to 14 and MAXIMUM NUMBER OF MESSAGES  to
  1776.        200,  RAMSG  will  delete any message in that area which  is
  1777.        either  over 14 days old as well as the oldest  messages  in
  1778.        the  area  until there are only 200 messages  left.  If  the
  1779.        message  area is important,  say user-to-user private  mail,
  1780.        you  can  instruct RAMSG to delete only messages which  have
  1781.        already been received that are a certain number of days  old
  1782.        by  setting  the  DAYS AFTER RECEIVED  MESSAGES  ARE  KILLED
  1783.        option.
  1784.  
  1785.        The  AKA  ADDRESS  and  ORIGIN LINE  options  are  used  for
  1786.        EchoMail type areas.  You can set different origin lines for
  1787.        each area,  along with any one of your network addresses, to
  1788.        be  appended  to the end of messages that are posted in  the
  1789.        area. If no origin line is specified, then RemoteAccess will
  1790.        use  the  origin  line defined in the  DEFAULT  ORIGIN  LINE
  1791.        option.
  1792.  
  1793.        Access to the message area is controlled by READ,  WRITE and
  1794.        SYSOP security levels and access flags. Read Security is the
  1795.        minimum security level the user needs to be allowed to  read
  1796.        messages in each message area. Likewise, message posting and
  1797.        replying  is only permitted if the user's security level  is
  1798.        equal  to or higher than the Write Security  setting.  SYSOP
  1799.        security access permits reading of all messages in the area,
  1800.        even if they are private and addressed to another user. This
  1801.        is useful  for  message  areas  which  are  run by assistant
  1802.        sysops and the like, so they can check messages for suitable
  1803.        content  and  delete off-topic ones.  A full  discussion  on
  1804.        security can be found in the SECURITY section.
  1805.  
  1806.        Going  back  to  the  MESSAGES  main  menu  option,   select
  1807.        EXTERNAL  EDITOR.  This is the DOS command line that will be
  1808.        used  to activate a full screen message editor,  if  one  is
  1809.        installed.  This  option is available only to users of  ANSI
  1810.        graphics.  The  full screen editor is a third-party  package
  1811.        that  enables messages to be entered in a  "word-processing"
  1812.        environment,   with  cursor  movement  and  text  formatting
  1813.        ability.   QuickEd  is  one  such  package  that  interfaces
  1814.        directly to RemoteAccess.  This command line may contain any
  1815.        of  the metacommands listed in the description of the type 7
  1816.        menu  command,  including  *M to swap  RemoteAccess  out  of
  1817.        memory before the editor is loaded.
  1818.  
  1819.        Go  to the QUIT menu,  and select "Yes" to save any  changes
  1820.        that  have  been  made.   This  completes  the  tutorial  on
  1821.        RACONFIG.
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.                                     27
  1832.        SECURITY            
  1833.        ────────────────────────────────────────────────────────────
  1834.  
  1835.        All user-security is controlled by a security level and  set
  1836.        of access flags.  The security level is any number from 1 to
  1837.        64,000.  Setting  a user's security level to zero will  lock
  1838.        him or her out of the BBS. There are thirty-two access flags
  1839.        arranged  in  four sets of eight individual flags,  each  of
  1840.        which can be either ON or OFF.  An ON flag is represented by
  1841.        an "X", and an OFF flag by a "-".
  1842.  
  1843.        Firstly let's look at menu security. Each menu is made up of
  1844.        a number  of  lines,  each  of  which  may  have  a  command
  1845.        associated with it.  (The  structure  of menus  is explained
  1846.        fully  in the next section).  In order for a menu line to be
  1847.        visible  (and  selectable) to a user,  the  user's  security
  1848.        level  must be equal to or greater than the  security  level
  1849.        assigned to that line.  In addition to this, every flag that
  1850.        is set ON in the menu line must also be set ON in the user's
  1851.        flag setting. 
  1852.  
  1853.        Read/Write  and Sysop access to message areas is  controlled
  1854.        in the same way. To be able to read messages in an area, the
  1855.        user  must  have not only a sufficient security  level,  but
  1856.        also  at  least the flags that are defined in  RACONFIG  for
  1857.        that  area.  Similarly,  the file area access  security/flag
  1858.        system works in the same way,  BUT the settings only  affect
  1859.        the   three   file  search  menu  functions.   To   restrict
  1860.        up/download  access to certain areas,  you will have to  use
  1861.        menu security.
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.                                     28
  1893.        MENUS                                   
  1894.        ────────────────────────────────────────────────────────────
  1895.  
  1896.        This  is  possibly the most important stage  in  configuring
  1897.        your  BBS.  The  menus that you create will give the  system
  1898.        it's own "feel",  and will make your system look  completely
  1899.        different from the one next door.  The menu system gives you
  1900.        one hundred percent flexibility not  only  cosmetically, but
  1901.        in allowing and disallowing access to certain functions  and
  1902.        parts of your BBS to groups of users.
  1903.  
  1904.        The menus are line-oriented. Using the menu editor supplied,
  1905.        you  enter the lines one at a time.  Each line has a line of
  1906.        text that is displayed to the user, a menu "type", a minimum
  1907.        security  level  and flag setting required  to  access  that
  1908.        line,  and  some  optional  data that is used by  some  menu
  1909.        types. 
  1910.  
  1911.        There  are  approximately sixty menu functions that  may  be
  1912.        activated  by the user pressing the key you have  linked  to
  1913.        that  function.  These functions are explained fully in  the
  1914.        following pages.
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.                                     29
  1954.        Menu functions                            
  1955.  
  1956.  
  1957.        Type          : 1
  1958.        Name          : Goto another menu
  1959.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-]
  1960.                        [/M=<Message Area>|+|-] 
  1961.  
  1962.        This function causes a jump to another menu,  which has been
  1963.        created  with  the  editor  and saved  as  <Menu  Name>.  If
  1964.        [Password]  is  specified  then the user will  be  asked  to
  1965.        supply  a  non-case-sensitive  password  before  proceeding.
  1966.        <File  Area> and <Message Area> set the  currently  selected
  1967.        file and message areas respectively for the template system.
  1968.        See the section on MENU TEMPLATES for a full explanation  on
  1969.        this.
  1970.  
  1971.  
  1972.  
  1973.        Type          : 2
  1974.        Name          : Gosub another menu
  1975.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-] 
  1976.                        [/M=<Message Area>|+|-] 
  1977.  
  1978.        As for Function 1,  but saves the path to the last menu on a
  1979.        "stack",  making  it possible to return to the calling  menu
  1980.        with  a type 3 function.  Note that menus called in this way
  1981.        may be nested to a maximum of 50 levels.
  1982.  
  1983.  
  1984.  
  1985.        Type          : 3
  1986.        Name          : Return from gosub 
  1987.        Optional Data : None
  1988.  
  1989.        Use  this  function to return from a Gosub (type 2)  to  the
  1990.        previous menu.
  1991.  
  1992.  
  1993.  
  1994.        Type          : 4
  1995.        Name          : Goto menu after clearing menu stack
  1996.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-]
  1997.                        [/M=<Message Area>|+|-] 
  1998.  
  1999.        As for function 1,  but  before jumping to the new menu, the
  2000.        gosub menu stack is cleared.  Obviously you can't use a type
  2001.        3 return straight after this!
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.                                     30
  2015.        Type          : 5
  2016.        Name          : Display a *.ASC/*.ANS text file
  2017.        Optional Data : <1-8 character name>
  2018.  
  2019.        Displays  a file in your textfile directory (as  defined  in
  2020.        RACONFIG). If the user has ANSI enabled, then <Filename.ANS>
  2021.        will  be displayed.  If the user does not have ANSI enabled,
  2022.        or  <Filename.ANS>  is missing then <Filename.ASC>  will  be
  2023.        displayed.  It  is possible to display comprehensive  system
  2024.        and  user details by inserting special control codes in  the
  2025.        file.  These codes are listed in the TEXT FILE CONTROL CODES
  2026.        section.
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.                                     31
  2076.        Type          : 6
  2077.        Name          : Bulletin menu
  2078.        Optional Data : <1-8 character name>
  2079.  
  2080.        Displays  the  <1-8 character name> file in your  text  file
  2081.        directory as does function type 5. The user is then prompted
  2082.        for a file suffix of length 8 - <length of file>. The suffix
  2083.        is appended to the original file name, and that text file is
  2084.        displayed as it would be in a type 5 function.  For example,
  2085.        if  the  optional  data  field  contained  a  file  name  of
  2086.        BULLET, the  file BULLET.ASC/ANS would  be  displayed.  Then
  2087.        the  user is prompted for a 2 character input.  If the  user
  2088.        typed  in "1B",  then the file "BULLET1B.ASC/ANS"  would  be
  2089.        displayed.  The  original text file defined in the  optional
  2090.        data should therefore contain a list of available bulletins.
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.                                     32
  2137.        Type          : 7
  2138.        Name          : Run an external program in a shell
  2139.        Optional Data : <Command Line> [Control Codes]
  2140.  
  2141.        This  command  will run an external program (a "door") in  a
  2142.        shell while the user is on-line. Examples are on line games,
  2143.        mail-checking facilities and so on. (Refer also to type 15 -
  2144.        Exit  to  DOS  for an alternative way  of  running  external
  2145.        programs). The FULL name of the program must be specified if
  2146.        it is an .EXE or .COM file.  To run one of these two  simply
  2147.        put  the name of the program in the optional data field.  If
  2148.        you  wish  to  call a batch file,  this  must  be  done  via
  2149.        COMMAND.COM,  the memory-resident command-line processor. So
  2150.        to  run  your TradeWars batch file,  the command line  could
  2151.        read:
  2152.  
  2153.             C:\COMMAND.COM /C \BBS\DOORS\TW2.BAT
  2154.  
  2155.        Many programs require extra information to be passed on  the
  2156.        command line, so the following control codes may be used. In
  2157.        each case, the code is replaced by it's value:
  2158.  
  2159.  
  2160.             *B : User's baud rate, or 0 if local
  2161.  
  2162.             *C : Full path and name to COMMAND.COM
  2163.  
  2164.             *F : User's first name
  2165.  
  2166.             *G : ANSI graphics, 0=Off/1=On 
  2167.  
  2168.             *H : Normally  the  FOSSIL  is  de-initialised   before
  2169.                  running an external program to avoid any possible 
  2170.                  conflicts  between  the  FOSSIL and  the  program.
  2171.                  Specifying this parameter leaves the FOSSIL  "hot"
  2172.                  or active. 
  2173.  
  2174.             *L : User's last name
  2175.  
  2176.             *M : Activate MemorySwap feature. RemoteAccess attempts
  2177.                  to  swap itself and all the memory it occupies  to
  2178.                  EMS  (if  installed) and disk,  leaving  only  20k
  2179.                  resident.    Great   for   running   memory-hungry
  2180.                  programs,  but  it  takes a few seconds to do  the
  2181.                  swap.  If  it  can't do the swap,  it will  try  a
  2182.                  normal shell.  NOTE :  Some programs are notorious
  2183.                  for  "fragmenting" memory,  and will not work with
  2184.                  MemorySwap.  Programs compiled in QuickBASIC, such
  2185.                  as TradeWars 1000 exhibit this problem.
  2186.  
  2187.             *N : Line number,  as specified  by the -N command line
  2188.                  parameter
  2189.  
  2190.             *P : Communications port being used (1-4)
  2191.  
  2192.             *R : User's record number in the user file
  2193.  
  2194.             *T : Time remaining for current call
  2195.  
  2196.  
  2197.                                     33
  2198.             *! : Freeze  the  system timer  for the duration of the
  2199.                  shell.  Useful for running external utilities like
  2200.                  full-screen chat programs etc.
  2201.  
  2202.             *# : Turn off the "Wants Chat" indicator on return     
  2203.                  from the shell. This is to facilitate proper      
  2204.                  installation of external chat utilities.
  2205.  
  2206.             *0 : The full path to the currently selected file      
  2207.                  template area.
  2208.  
  2209.             *1 : The number of the currently selected template     
  2210.                  message area.
  2211.  
  2212.  
  2213.        In  addition  to this command line information that  can  be
  2214.        passed,  RemoteAccess also creates two data files before the
  2215.        shell.  DORINFO1.DEF,  which is a RBBS-compatible file,  and
  2216.        EXITINFO.BBS,  which  contains  an  extremely  comprehensive
  2217.        amount of system and user information. The structure of this
  2218.        file  can be found in the RemoteAccess structures  document,
  2219.        RASTRUCT.  It should also be noted that ALL system files are
  2220.        written  to  and closed off before the shell  is  activated,
  2221.        then  reopened  and scanned upon  return.  This  means  that
  2222.        programs  that  modify system files (eg.  USERS.BBS) can  be
  2223.        safely run in a type 7 shell.
  2224.  
  2225.        Note  that the external program must do it's own time  limit
  2226.        and  carrier watchdogging,  in the event that the user  does
  2227.        not exit from the program correctly.
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.                                     34
  2259.        Type          : 8
  2260.        Name          : Product information
  2261.        Optional Data : None
  2262.  
  2263.        Displays  product  information including the version  number
  2264.        and  copyright information.  If a user is on-line  remotely,
  2265.        the name and version of the FOSSIL in use is also displayed.
  2266.  
  2267.  
  2268.  
  2269.        Type          : 9
  2270.        Name          : Terminate the session
  2271.        Optional Data : None
  2272.  
  2273.        Displays  the GOODBYE.ASC/ANS text file and hangs up on  the
  2274.        user by dropping the DTR signal to the modem.  To this  end,
  2275.        make  sure  your  modem's  DTR line  is  not  "forced  high"
  2276.        continuously.
  2277.  
  2278.  
  2279.  
  2280.        Type          : 10
  2281.        Name          : System usage
  2282.        Optional Data : None
  2283.  
  2284.        Displays  a nicely  formatted full-screen autoscaling  graph
  2285.        that   depicts system usage  in terms of  percentage use per
  2286.        hour.  To reset  this graph,  delete the  file "TIMELOG.BBS"
  2287.        from your system directory.
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.                                     35
  2320.        Type          : 11
  2321.        Name          : Page sysop to chat
  2322.        Optional Data : <Paging string>
  2323.  
  2324.        Displays the <paging string> to the user and pages the sysop
  2325.        for a chat.  The sysop may select "C" to chat with the user,
  2326.        or "A" to abort the page. You may break in for a chat at any
  2327.        time  by  pressing ALT-C.  All sysop keys are listed in  the
  2328.        reference section of this manual.  During a chat, the system
  2329.        timer  is  "frozen",  and  is re-started when  the  chat  is
  2330.        terminated.  The sysop terminates chat mode with the  ESCape
  2331.        key.  During  chat,  you may open a capture file to log  the
  2332.        chat  session  by pressing CTRL-A,  and again to  close  the
  2333.        capture.
  2334.  
  2335.        The default paging sound is a constant "beep-beep" tone  for
  2336.        the duration of the page. You may define your own page sound
  2337.        by  creating  a  text  file called  PAGE.RA  in  the  system
  2338.        directory. The following keywords are valid:
  2339.  
  2340.  
  2341.          TONE [hz] [1/100's sec]   (sounds hz)
  2342.          WAIT [1/100's sec]        (sounds nothing)
  2343.  
  2344.  
  2345.        The following  table lists  several musical octaves  and the
  2346.        correct frequency value associated with each note:
  2347.  
  2348.  
  2349.          Note  Oct - 1    2    3    4    5    6
  2350.          ----        
  2351.          C       F   45  134 268  536 1071 2145
  2352.          C#      r   71  142 284  568 1136 2273
  2353.          D       e   75  150 301  602 1204 2408
  2354.          D#      q   80  159 319  638 1275 2551
  2355.          E       u   84  169 338  676 1351 2703
  2356.          F       e   90  179 358  716 1432 2864
  2357.          F#      n   95  190 379  758 1517 3034
  2358.          G       c   100 201 402  804 1607 3215
  2359.          G#      y   106 213 426  851 1703 3406
  2360.          A       #   113 225 451  902 1804 3608
  2361.          A#          119 239 478  956 1991 3823
  2362.          B           127 253 506 1012 2025 4050
  2363.  
  2364.  
  2365.        The  RemoteAccess distribution  archive  contains  a  sample
  2366.        PAGE.RA file to get you started.
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.                                     36
  2381.        Type          : 12
  2382.        Name          : Questionnaire
  2383.        Optional Data : <1-8 character file name> [/N]
  2384.  
  2385.        Initiates a questionnaire. The <file name> is the first part
  2386.        of  the  name of the questionnaire file.  All  questionnaire
  2387.        files  are stored in the system directory,  and have a  name
  2388.        extension of .Q-A.  User's responses are stored in an output
  2389.        file  named  <file name>.ASW.  There is a full  tutorial  on
  2390.        questionnaires,   including  the  script  language  in   the
  2391.        reference section of this manual.
  2392.  
  2393.        RemoteAccess has a hard-coded questionnaire.  If present, it
  2394.        will  initiate the questionnaire NEWUSER.Q-A for a new  user
  2395.        after   the   hard-coded  text  file   NEWUSER2.ASC/ANS   is
  2396.        displayed.  For information on hard-coded (external support)
  2397.        files, refer to the EXTERNAL SUPPORT FILES section.
  2398.  
  2399.        Normally the initiation of  a questionnaire is noted  in the
  2400.        system log. Placing the /N parameter after the questionnaire
  2401.        name on the optional data line will suppress this log entry.
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.                                     37
  2442.        Type          : 13
  2443.        Name          : User listing
  2444.        Optional Data : None
  2445.  
  2446.        Displays a list of users in the user file. Lists users name,
  2447.        location,  file ratio,  and the last time he/she called  the
  2448.        system.  This  function  has  some  basic  pattern  matching
  2449.        capabilities on the name field.
  2450.  
  2451.  
  2452.  
  2453.        Type          : 14
  2454.        Name          : Time
  2455.        Optional Data : None
  2456.  
  2457.        Shows the current date and time, along with the user's daily
  2458.        time limit, time used and time remaining for the day.
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.                                     38
  2503.        Type          : 15
  2504.        Name          : Exit to DOS
  2505.        Optional Data : <Errorlevel>
  2506.  
  2507.        This  function  causes RemoteAccess exit to the  batch  file
  2508.        that  executed  it,  with  a specific  errorlevel.  Set  the
  2509.        optional  data  to the errorlevel you wish to  pass  to  the
  2510.        batch  file.  The batch file should trap the errorlevel  and
  2511.        act  accordingly.  If  you exit while the user is still  on-
  2512.        line, to log the user back on invoke RemoteAccess with the -
  2513.        R  command line parameter.  This will force it to  read  the
  2514.        EXITINFO  file that was written at the time of the  previous
  2515.        exit  and take the user directly to the top menu.  Note that
  2516.        errorlevels  0 to 5 are reserved by RemoteAccess for  system
  2517.        use (see the reference section on ERRORLEVELS for a complete
  2518.        list  and  description of these and how to  use  them),  and
  2519.        should not be used.
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.                                     39
  2564.        Type          : 16
  2565.        Name          : Alter location
  2566.        Optional Data : None
  2567.  
  2568.        Allows  the user to change the "location" field  in  his/her
  2569.        user record.
  2570.  
  2571.  
  2572.  
  2573.        Type          : 17
  2574.        Name          : Alter password
  2575.        Optional Data : None
  2576.  
  2577.        Allows  the  user  to  change  his/her  password.   Frequent
  2578.        password  changes  should  be encouraged  to  ensure  system
  2579.        security,  and  in fact there is an option to force a change
  2580.        of   password   every  certain  number  logons   (refer   to
  2581.        "RACONFIG").
  2582.  
  2583.  
  2584.  
  2585.        Type          : 18
  2586.        Name          : Alter screen length
  2587.        Optional Data : None
  2588.  
  2589.        Allows  the  user  to alter the  length  of  his/her  screen
  2590.        display. This affects the "Continue?" prompt.
  2591.  
  2592.  
  2593.  
  2594.        Type          : 19
  2595.        Name          : Toggle screen clearing
  2596.        Optional Data : None
  2597.  
  2598.        Allows  the user to specify whether he/she would like screen
  2599.        clearing codes sent.
  2600.  
  2601.  
  2602.  
  2603.        Type          : 20
  2604.        Name          : Toggle page pausing
  2605.        Optional Data : None
  2606.  
  2607.        Allows the user to enable or disable the "Continue?"  prompt
  2608.        at the end of each screen page.
  2609.  
  2610.  
  2611.  
  2612.        Type          : 21
  2613.        Name          : Toggle ANSI graphics
  2614.        Optional Data : None
  2615.  
  2616.        Allows the user to select, or deselect ANSI graphics. If the
  2617.        user disables ANSI, use of the full screen message editor is
  2618.        also disabled. 
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.                                     40
  2625.        Type          : 22
  2626.        Name          : Check the mailbox
  2627.        Optional Data : None
  2628.  
  2629.        Checks  to  see if there is any mail addressed to  the  user
  2630.        that he/she hasn't yet read.  This can be done automatically
  2631.        at log-on by setting the appropriate option in RACONFIG. See
  2632.        the section on configuration for details of the two types of
  2633.        mail-check available.  All new messages are marked for later
  2634.        retrieval with the "Read Marked" option.  Note that the user
  2635.        will  only be notified of mail in areas that he/she has read
  2636.        access to,  as defined in RACONFIG. Although the system only
  2637.        prompts  the  user with a "Read mail now  [Yes/no]"  prompt,
  2638.        several options can be activated.  Valid choices are [R]ead,
  2639.        [S]can, [Q]uickscan, [K]ill, or [M]ark as received.
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.                                     41
  2686.        Type          : 23
  2687.        Name          : Read messages
  2688.        Optional Data : <Message area #> or /M
  2689.  
  2690.        Initiates the message reading routines. Checks that the user
  2691.        has  read  access to the message area first.  The  user  may
  2692.        select several different scan modes.  These include forward,
  2693.        reverse,  new messages, marked messages, individual message,
  2694.        or  a  selected  scan according to  the  "To:",  "From:"  or
  2695.        "Subject"  fields.  Online help is also available from  this
  2696.        hard-coded menu in the form of a text file.  Put the message
  2697.        area  number  on the optional data field,  or  0  to  select
  2698.        "combined"  mode  (see  function type 28 for  more  on  this
  2699.        feature).  If  you put a "/M" in the optional data field  in
  2700.        place  of the area number,  RemoteAccess will  automatically
  2701.        substitute the currently selected template message area into
  2702.        the  data field.  See MENU TEMPLATES for more on  this.  The
  2703.        message area number refers to number assigned to the desired
  2704.        area in RACONFIG.
  2705.  
  2706.        The  menu  bar  at the  end  of  each  message provides  the
  2707.        following functions:
  2708.  
  2709.        [-] : Read previous reply
  2710.        [+] : Read next reply
  2711.        [A] : Redisplay message again
  2712.        [N] : Go to the next message
  2713.        [L] : Go back to the previous message
  2714.        [R] : Post a reply to the current message
  2715.        [E] : Enter a new message in the current area
  2716.        [D] : Delete the displayed message (check the "delete msg"  
  2717.              menu function for more information)
  2718.        [S] : Stop reading messages
  2719.  
  2720.        The following options are  available only to users who  have
  2721.        sysop access to the message area:
  2722.  
  2723.        [!] : Display ^A kludge lines normally hidden
  2724.        [*] : Edit the current message's attributes
  2725.        [X] : Export message to a file or the printer
  2726.        [F] : Forward message to another user in any area
  2727.        [=] : Mark message as unreceived and go to the next message
  2728.        [U] : Modify the security level of the user who posted the  
  2729.              currently displayed message, provided the user is     
  2730.              listed in the userfile. Great for "on the fly" user   
  2731.              verification! {+} Only available in registered        
  2732.              version.
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.                                     42
  2747.        Type          : 24
  2748.        Name          : Scan messages
  2749.        Optional Data : <Message area #> or /M
  2750.  
  2751.        Same  as  the  READ  message function  (type  23)  but  only
  2752.        displays  the message header of each message.  The user also
  2753.        has the option of marking messages for later retrieval.
  2754.  
  2755.  
  2756.  
  2757.        Type          : 25
  2758.        Name          : QuickScan messages
  2759.        Optional Data : <Message area #> or /M
  2760.  
  2761.        Same as the READ message function (type 23) but each message
  2762.        is listed as a single-line entry containing message  number,
  2763.        the poster of the message,  who it is addressed to,  and the
  2764.        subject line.
  2765.  
  2766.  
  2767.  
  2768.        Type          : 26
  2769.        Name          : Delete message
  2770.        Optional Data : None
  2771.  
  2772.        Allows a user to delete a message provided that:
  2773.  
  2774.        * The user has sysop access to the area the message is in,  
  2775.          OR
  2776.  
  2777.        * The message is in a LOCAL or NETMAIL area and the user is 
  2778.          the sender or recipient of the message, OR
  2779.  
  2780.        * The message is in an echomail area and the user is the    
  2781.          sender of the message, provided the message has not been  
  2782.          exported from the message-base.
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.                                     43
  2808.        Type          : 27
  2809.        Name          : Post message
  2810.        Optional Data : <Message Area #> or /M [/L] [/T=<Name>]
  2811.  
  2812.        Post  a  message  in the specified area  (or  the  currently
  2813.        selected  template area if the "/M" is used).  The user must
  2814.        have  either write or sysop access to the message  area,  as
  2815.        defined  in RACONFIG.  The /L option will log the  user  off
  2816.        immediately  after the message is saved (useful for a "Leave
  2817.        message  to  sysop before disconnecting"  option).  The  /T=
  2818.        option will force the message to be addressed to a  specific
  2819.        user.  Simply  place  the user's name in the  optional  data
  2820.        field  after  the /T= parameter to select this  option.  For
  2821.        example, on my "log-off" menu, I have the following entry:
  2822.  
  2823.        Menu Type 27
  2824.        Optional Data: 60 /L /T=Andrew_Milner
  2825.  
  2826.        (Any messages to "Sysop" are redirected to the sysop's  name
  2827.        as defined in RACONFIG).  If you do use a full name, be sure
  2828.        to use underscores in place of spaces.
  2829.  
  2830.        Specifying a message area number of zero forces RemoteAccess
  2831.        to  display all message areas that the user has write access
  2832.        to and prompt for the message area to post the message in.
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.                                     44
  2869.        Type          : 28
  2870.        Name          : Select combined areas
  2871.        Optional Data : None
  2872.  
  2873.        Allows  the user to select any combination of message  areas
  2874.        for  "combined" mode message reading/scanning/quickscanning.
  2875.  
  2876.        The  user is shown a list of available areas and may  toggle
  2877.        any  of  them "ON" or "OFF".  This combination of  areas  is
  2878.        saved  as part of the user's permanent user record,  and  is
  2879.        restored at next log on.  To read messages on the "combined"
  2880.        area, use a normal read/scan/quickscan menu function but set
  2881.        the message area number in the optional data field to  zero.
  2882.  
  2883.        Area  zero is hard-coded as this combined area and cannot be
  2884.        defined by the sysop.
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.                                     45
  2930.        Type          : 29
  2931.        Name          : Move a file
  2932.        Optional Data : <Full source path>
  2933.  
  2934.        Primarily intended as a sysop/assistant sysop function, this
  2935.        allows  the  user  to move files  from  a  pre-defined  area
  2936.        <source-path>  to  any valid DOS directory without the  need
  2937.        for remote access  to DOS.  After the file  has been  copied
  2938.        successfully,  RemoteAccess will optionally  move the file's
  2939.        description (if there is one) to the destination directory.
  2940.  
  2941.  
  2942.  
  2943.        Type          : 30
  2944.        Name          : Directory
  2945.        Optional Data : <Full path> or /F
  2946.  
  2947.        Displays   an  MS-DOS  style  directory  of  the   directory
  2948.        specified in the optional data field,  showing name,  length
  2949.        and date of each  file. The user is prompted for an optional
  2950.        wildcard / pattern match filespec.
  2951.  
  2952.  
  2953.  
  2954.        Type          : 31
  2955.        Name          : List files
  2956.        Optional Data : <Full path> or /F
  2957.  
  2958.        This option displays a list of files available for  download
  2959.        from  the  directory  specified  by the  path  name  in  the
  2960.        optional  data  field.  The file names and descriptions  are
  2961.        contained  in  a  file  called  FILES.BBS.   This  file   is
  2962.        automatically  maintained  by  RemoteAccess when  files  are
  2963.        uploaded,  but it may also be edited by the sysop.  The file
  2964.        consists  of  a  single  word  file-name  per  line  with  a
  2965.        description,  up to 255 characters in  length.  Descriptions
  2966.        that  exceed  the  width  of the  screen  are  automatically
  2967.        wrapped to the next line. The upload date and length of each
  2968.        file is also displayed (optionally),  and an asterisk before
  2969.        the  description  signifies that the file is new  since  the
  2970.        user's last call.
  2971.  
  2972.        If,  instead  of the full path to the file area,  you put  a
  2973.        "/F",  RemoteAccess  will  substitute  the  path  name  that
  2974.        corresponds to the currently selected template file area, as
  2975.        defined  in  RACONFIG.  See the MENU  TEMPLATE  section  for
  2976.        further information on this.
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                                     46
  2991.        Type          : 32
  2992.        Name          : Download a file from area
  2993.        Optional Data : <Full path> or /F [Password]
  2994.  
  2995.        Enables  the user to download any file that is contained  in
  2996.        the  specified  directory.  Note that the file need  not  be
  2997.        listed in that directory's FILES.BBS for the user to be able
  2998.        to download it. If a password is specified, the user will be
  2999.        asked for a non case-sensitive password before being allowed
  3000.        to  proceed  with the transfer.  The /F option works in  the
  3001.        same way as in function 31. 
  3002.  
  3003.                         
  3004.  
  3005.  
  3006.        Type          : 33
  3007.        Name          : Upload a file
  3008.        Optional Data : <Full path> or /F
  3009.  
  3010.        Enables the user to upload (send) a file to your system. The
  3011.        file  will  be  placed in the  directory  specified  in  the
  3012.        optional data path.  FILES.BBS will be automatically updated
  3013.        to reflect the upload.  The /F option works in the same  way
  3014.        as in function 31 and 32.
  3015.  
  3016.  
  3017.  
  3018.        Type          : 34
  3019.        Name          : View archive
  3020.        Optional Data : <Full path> or /F
  3021.  
  3022.        Allows  the user to view the contents of an archived file in
  3023.        the specified directory. At present, only ZIP and LZH  files
  3024.        are supported, but this will be expanded in the future. Menu
  3025.        templating   is  supported  with the  /F  option.   This  is
  3026.        explained more fully in MENU TEMPLATES.
  3027.  
  3028.  
  3029.  
  3030.        Type          : 35
  3031.        Name          : File scan by keyword
  3032.        Optional Data : None
  3033.  
  3034.        This function uses the data specified in RACONFIG to  search
  3035.        all  file  areas that the user has access to for a  key-word
  3036.        that  is supplied by the user.  Any FILES.BBS  entries  that
  3037.        match  are displayed with the name of the area the match was
  3038.        found in.
  3039.  
  3040.  
  3041.  
  3042.        Type          : 36
  3043.        Name          : File scan by file name
  3044.        Optional Data : None
  3045.  
  3046.        Same as function 35, but scans for an exact file name match.
  3047.        Wildcard and pattern matching characters are valid. 
  3048.  
  3049.  
  3050.  
  3051.                                     47
  3052.        Type          : 37
  3053.        Name          : Show new files
  3054.        Optional Data : None
  3055.  
  3056.        Scans  all file areas that the user has access to for  files
  3057.        that   have  a date  more recent than the  date specified by
  3058.        the user. The  default is to search for  files new since the
  3059.        users last log-on.
  3060.  
  3061.  
  3062.  
  3063.        Type          : 38
  3064.        Name          : Type (view) a text file
  3065.        Optional Data : <Full path> or /F
  3066.  
  3067.        Allows  the  user to type to the terminal the contents of  a
  3068.        plain ASCII/ANSI text file in the specified directory.  This
  3069.        is useful for on-line file lists or magazines. The /F option
  3070.        overrides the path name with the currently selected template
  3071.        file area path.
  3072.  
  3073.  
  3074.  
  3075.        Type          : 39
  3076.        Name          : Display a fully named text file
  3077.        Optional Data : <Full path and name>
  3078.  
  3079.        Similar  to the type 5 function,  but allows you to  specify
  3080.        the  full  path and name (including extension) of  the  file
  3081.        that will be displayed.  Like the type 5 function, this also
  3082.        interprets the special control characters.
  3083.  
  3084.  
  3085.  
  3086.        Type          : 40
  3087.        Name          : Display an ASC/ANS text file with hot keys
  3088.        Optional Data : <1-8 character name>
  3089.  
  3090.        Displays  an  ASC/ANS  text file the same way as  a  type  5
  3091.        would, but leaves the current menu hot keys active while the
  3092.        file is displayed. This allows the use of elaborate graphics
  3093.        in  your menus that would be impossible to create  with  the
  3094.        line  editor.  See  also  AUTOMATIC  COMMAND  EXECUTION  for
  3095.        details on how to integrate these files into your menus.
  3096.  
  3097.  
  3098.  
  3099.        Type          : 41
  3100.        Name          : Toggle full screen editor
  3101.        Optional Data : None
  3102.  
  3103.        Allows  the  user to select or deselect the use of the  full
  3104.        screen message editor.  Use of the editor is only  permitted
  3105.        if the user has ANSI graphics enabled.
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.                                     48
  3113.        Type          : 42
  3114.        Name          : Toggle hot-keys
  3115.        Optional Data : None
  3116.  
  3117.        Allows  the  user  to choose  between  hot-keys  or  command
  3118.        stacking.  In  command stacking mode,  several commands,  or
  3119.        key-presses, can be specified on one command line by putting
  3120.        a semi-colon in between each command.
  3121.  
  3122.  
  3123.  
  3124.        Type          : 43
  3125.        Name          : NewMail {+}
  3126.        Optional Data : None
  3127.  
  3128.        Display a full  list of all the  message areas the user  has
  3129.        read access  to,  highlighting  those  that  contain  unread
  3130.        messages.
  3131.  
  3132.  
  3133.  
  3134.        Type          : 44
  3135.        Name          : Reset combined areas setting
  3136.        Optional Data : None
  3137.  
  3138.        Allows  the user turn ON or OFF all available message  areas
  3139.        for his/her combined message area setting.
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                                     49
  3174.        Type          : 45
  3175.        Name          : Display text file and wait
  3176.        Optional Data : <1-8 character name>
  3177.  
  3178.        This is the same as a type 5 function,  but prompts the user
  3179.        to  press  [Return] before continuing.  This is  useful  for
  3180.        displaying  text  files that are generated automatically  by
  3181.        utilities that don't append a Control-A (wait character)  at
  3182.        the end of the file.
  3183.  
  3184.  
  3185.  
  3186.        Type           : 46
  3187.        Name           : Display direct textfile with CR
  3188.        Optional Data  : <Full path and name>
  3189.  
  3190.        Displays  a text file with  a fully qualified  path and name
  3191.        and waits for the user to press [Return] before continuing.
  3192.  
  3193.  
  3194.  
  3195.        Type          : 47
  3196.        Name          : Make a log entry
  3197.        Optional Data : <Log entry>
  3198.  
  3199.        When this command is executed,  it simply takes the contents
  3200.        of  the Optional Data field and writes it to the system  log
  3201.        as if it were a normal hard-coded log entry.  The only macro
  3202.        characters that are valid are:
  3203.  
  3204.             @ : Insert the name of the current template file area
  3205.             ` : Insert the name of the current template msg area
  3206.  
  3207.  
  3208.  
  3209.        Type          : 48
  3210.        Name          : Download a specific file
  3211.        Optional Data : <Full path and name>
  3212.  
  3213.        Enables the user to download a file or set of files that you
  3214.        have  pre-defined,  using  a protocol of the user's  choice.
  3215.        Note  that  you  may specify wild-cards  and  pattern  match
  3216.        characters in the file name, but if you do, the user will be
  3217.        forced to use a batch transfer protocol. For example, a type
  3218.        48 command with the following optional data field:
  3219.  
  3220.             C:\FILES\RA\RELEASE\RA*.ZIP
  3221.  
  3222.        Would  send all files in the  C:\FILES\RA\RELEASE  directory
  3223.        that matched RA*.ZIP.
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.                                     50
  3235.        Type          : 49
  3236.        Name          : Select message area
  3237.        Optional Data : None
  3238.  
  3239.        Displays  a  list of  all message  areas  the user  has read
  3240.        access to,  and asks the  user to select one  by number. The
  3241.        current  message template  area number is  set to  the users
  3242.        choice.  This allows the sysop to run a very low maintenance
  3243.        system,  since all  that  is required  to  add or  delete  a
  3244.        message  area  is  to  modify  the  configuration  file  via
  3245.        RACONFIG.
  3246.  
  3247.  
  3248.  
  3249.        Type          : 50
  3250.        Name          : Select file area
  3251.        Optional Data : None
  3252.  
  3253.        This operates in the  same way as the "select  message area"
  3254.        (type  49) menu  function,  but uses  file areas  instead of
  3255.        message areas.
  3256.  
  3257.  
  3258.  
  3259.        Type          : 51
  3260.        Name          : List today's callers
  3261.        Optional Data : None
  3262.  
  3263.        Lists  every  caller  that  has  called  your  system  since
  3264.        midnight  along with log on/off times,  baud rate  and  what
  3265.        line the call was taken on.
  3266.  
  3267.  
  3268.  
  3269.        Type          : 52
  3270.        Name          : Show all users on-line
  3271.        Optional Data : None
  3272.  
  3273.        Lists all users currently on-line. This would only be useful
  3274.        in a multi-line installation.  It shows where each caller is
  3275.        calling  from,  their  baud  rate  and  the  line  they  are
  3276.        connected to.
  3277.  
  3278.  
  3279.  
  3280.        Type          : 53
  3281.        Name          : Toggle "Do not disturb"
  3282.        Optional Data : None
  3283.  
  3284.        This  another  multi-line feature only.  It allows the  user
  3285.        turn  on or off the ability of other users to  send  him/her
  3286.        messages  whith  the type 54 function,  like - "Hey  Joe,  I
  3287.        noticed  that you're on line 3.  Wanna chat?" Note that  the
  3288.        sysop  has the ability to override this and send  a  message
  3289.        anyway.
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.                                     51
  3296.        Type          : 54
  3297.        Name          : Send an on-line message
  3298.        Optional Data : None
  3299.  
  3300.        Allows  the  user to send a message to another user  who  is
  3301.        logged on to  another line at the same time.  Provided  that
  3302.        the  other  user has not set his/her "do not disturb"  flag,
  3303.        the  sender  will be prompted for a one-liner  to  transmit.
  3304.  
  3305.        Depending on what the recipient is doing at the time, he/she
  3306.        will get the message ten to fifteen seconds later.
  3307.  
  3308.  
  3309.  
  3310.        Type          : 55
  3311.        Name          : Download any file
  3312.        Optional Data : None
  3313.  
  3314.        This  is an extremely powerful function that should be  only
  3315.        accessible  by the sysop.  It allows the user to download  a
  3316.        file  from  any  valid drive or directory using any  of  the
  3317.        available file transfer protocols.  Note that this the  ONLY
  3318.        download  function that takes no account of download limits,
  3319.        file ratios or transfer time,  and does not update the users
  3320.        record to reflect the download.
  3321.  
  3322.  
  3323.  
  3324.        Type           : 56
  3325.        Name           : Browse the nodelist {+}
  3326.        Optional Data  : None
  3327.  
  3328.        Allows the  user to browse the  nodelist. Includes functions
  3329.        to list all zones, list all nets and regions in  a zone, and
  3330.        list all nodes in a net or region.
  3331.  
  3332.  
  3333.  
  3334.        Type           : 57
  3335.        Name           : Change home/voice number
  3336.        Optional Data  : None
  3337.  
  3338.        Allows the  user to  modify his/her home/voice  phone number
  3339.        permanently.
  3340.  
  3341.  
  3342.  
  3343.        Type           : 58
  3344.        Name           : Change business/data number
  3345.        Optional Data  : None
  3346.  
  3347.        Allows the user to modify his/her business/data phone number
  3348.        permanently.
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.                                     52
  3357.        Automatic command execution                            
  3358.        ────────────────────────────────────────────────────────────
  3359.  
  3360.        Normally  a  menu  function would be activated when  a  user
  3361.        presses  the  key  that you have linked  to  that  function.
  3362.        However,  it is possible to cause a function to be  executed
  3363.        automatically  as soon as a menu is displayed by setting the
  3364.        entry to "auto execute". As  soon as that  particular  menu 
  3365.        line    is     displayed  the     function    is    executed
  3366.        automatically,  without the need for the user to select  the
  3367.        option.  This  is a very powerful feature when used with the
  3368.        type  40 menu function,  which displays an  ASCII/ANSI  text
  3369.        file  while  checking for menu hot-keys.  By setting up  the
  3370.        first line of a menu as a type 40 with automatic  execution,
  3371.        as  soon  as the menu is called your text file is  displayed
  3372.        instead of the normal menu lines.  This allows you to design
  3373.        very  elaborate graphical menu displays that  contain  extra
  3374.        information  about  the user by inserting the  special  text
  3375.        file control codes.  What happens if a user "passes through"
  3376.        a  menu by using a stacked menu command?  In some cases  you
  3377.        may  want the automatic command to execute,  for example  to
  3378.        redirect  the user to another menu by automatic execution of
  3379.        a type 1 or 2. On the other hand, if the command is only for
  3380.        cosmetic  purposes (maybe a text file to display  some  user
  3381.        statistics)  it  would  be better to skip  the  command  and
  3382.        continue   straight to the next  menu. The rule is  that the
  3383.        menu command will only be executed if  it is the first entry
  3384.        in  the menu  AND  it  is  not  a  'display  textfile'  type
  3385.        function. 
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.                                     53
  3418.        Menu templates                      
  3419.        ────────────────────────────────────────────────────────────
  3420.  
  3421.        The  biggest  drawback of other BBS packages that allow  the
  3422.        sysop  the flexibility of designing his or her own menus  is
  3423.        the amount of maintenance that is necessary in updating  the
  3424.        menus.  Until  now it was necessary to have a separate  menu
  3425.        for  each  file  and message  area.  The  RemoteAccess  menu
  3426.        templating system alleviates this problem by allowing you to
  3427.        set  up one menu that will act as a "skeleton" for all  your
  3428.        message  and  file areas.  Two "variables" are available  to
  3429.        you; "M" for the currently selected message area and "F" for
  3430.        the currently selected file area.  In your template menu(s),
  3431.        where you would normally put the message area number in  the
  3432.        optional  data field for say a "Read" command,  put in "/M".
  3433.  
  3434.        When  the read is selected by the  user,  RemoteAccess  will
  3435.        substitute this for a message area number.  Likewise,  where
  3436.        you would specify a full path for a file function, put a "/F
  3437.        in  the optional data field.  RemoteAccess will replace this
  3438.        variable with the path to the currently selected file area.
  3439.  
  3440.        To put a value into one of these two variables, simply put a
  3441.        "/M=<Area  Number>"  or "/F=<Area Number>" in  the  optional
  3442.        data field of a type 1,  2 or 4 menu command.  For  example,
  3443.        say   you  set  up  a  message  area  template  menu  called
  3444.        "MSGMENU", using the /M in the optional data fields. Another
  3445.        menu,  which  you have set up to list the available  message
  3446.        areas,  simply consists of type 1 or 2 menu commands to jump
  3447.        to MSGMENU. One menu line looks like this:
  3448.  
  3449.             <H>ard Disk Conference
  3450.  
  3451.        This is a type 2 command,  which will "gosub" to the MSGMENU
  3452.        menu:
  3453.  
  3454.             Type : 2
  3455.  
  3456.        On the optional data line,  put the name of the menu to jump
  3457.        to, and also set the template variable.
  3458.  
  3459.             Optional Data : MSGMENU /M=45
  3460.  
  3461.        45 corresponds to the hard disk conference area,  as defined
  3462.        in RACONFIG.
  3463.  
  3464.        There  are two other constructs that work with the  template
  3465.        commands. /M=+ or /F=+ will increment the currently selected
  3466.        template area  by one, and /M=- or /F=- will  decrement  the
  3467.        currently  selected template area by one.  RemoteAccess will
  3468.        automatically  scan  all  file (or  message)  areas  in  the
  3469.        specified direction to determine the next area that the user
  3470.        has been given access to.
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.                                     54
  3479.        NOTE:  When RemoteAccess fires up, both the file and message
  3480.        template areas default to area 1, as defined in RACONFIG. No
  3481.        checking is done to verify the user's access to this area at
  3482.        log-on,  so  you should set both file and message area 1  to
  3483.        either a blank entry,  or an area that all users have access
  3484.        to.
  3485.  
  3486.        There are a number of special characters that you can put in
  3487.        the display line of a menu which will display certain system
  3488.        information:
  3489.  
  3490.  
  3491.             ~  :  Displays time remaining today.
  3492.  
  3493.             ^  :  Switches between the normal line colours and  the
  3494.                   overall menu highlight colours. 
  3495.  
  3496.             ;  :  Don't display a carriage return / linefeed at the
  3497.                   end of the line.
  3498.  
  3499.             @  :  Displays the name (as defined in RACONFIG) of the
  3500.                   currently selected file template area.
  3501.  
  3502.             `  :  Displays the name (as defined in RACONFIG) of the
  3503.                   currently selected message template area.
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.                                     55
  3540.        Setting up your menus                      
  3541.        ────────────────────────────────────────────────────────────
  3542.  
  3543.        Spend  some  time thinking about how your menus will be  set
  3544.        up.  Your BBS can be made to look as unique or as  "uniform"
  3545.        as  you like - you can choose a subjective  topology,  where
  3546.        the  menus are organised according to area of interest, or a
  3547.        functional topology,  where menus are organised according to
  3548.        their  function.  For example,  a functional topology  would
  3549.        group  all  message  areas  together  and  all  file   areas
  3550.        together,  whereas a subjective topology would perhaps group
  3551.        together  several message and file areas that were  related.
  3552.  
  3553.        The  diagram  below illustrates this by depicting  the  same
  3554.        systems using the two different topologies:
  3555.  
  3556.        FUNCTIONAL
  3557.                                          +----------Amiga messages
  3558.                  +---------Messages menu |
  3559.                  |                       +----------IBM messages
  3560.        Main menu |
  3561.                  |                       +----------Amiga files
  3562.                  +------------Files menu |
  3563.                                          +----------IBM files
  3564.  
  3565.  
  3566.        SUBJECTIVE
  3567.                                          +----------IBM files
  3568.                  +--------------IBM menu | 
  3569.                  |                       +----------IBM messages
  3570.        Main menu |
  3571.                  |                       +----------Amiga files
  3572.                  +------------Amiga menu |
  3573.                                          +----------Amiga messages
  3574.  
  3575.  
  3576.        Alternatively,  you  could even use a combination of the two
  3577.        topology types.
  3578.  
  3579.        The  layout of your BBS is determined by how the  menus  are
  3580.        set up. In many cases a user will not realise that he or she
  3581.        is looking at a menu.  The best technique for creating menus
  3582.        is to create all the "low-level" menus first,  then the main
  3583.        menu, and then fill in between with the intermediate menus.
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.                                     56
  3601.        Creating your menus - RAMENU                               
  3602.        ────────────────────────────────────────────────────────────
  3603.  
  3604.        Change to the system directory and fire up RAMENU.EXE;  this
  3605.        is  the  utility  which allows you to create and  edit  your
  3606.        menus.  When  run  it will present you with a  directory  of
  3607.        menus  that have already been created - select one with  the
  3608.        cursor keys and press RETURN to edit, or simply press ESCAPE
  3609.        to create a new menu.
  3610.  
  3611.        A  large  window  is opened that displays  a  line  by  line
  3612.        summary  of the menu.  You may select a menu item to work on
  3613.        by moving the hilight bar to the item with the cursor  keys.
  3614.        The following keys are available:
  3615.  
  3616.  
  3617.        [RETURN]  - Edit the currently selected menu item.
  3618.  
  3619.        [INSERT]  - Insert  a new menu item immediately  before  the
  3620.                    current item.
  3621.  
  3622.        [DELETE]  - Delete the currently selected menu item.
  3623.  
  3624.        [ALT-D]   - Simulate  what  the menu  would look like  to  a
  3625.                    user.
  3626.  
  3627.        [ALT-P]   - View or modify the menu prompt,  its colour  and
  3628.                    the menu highlight colours.
  3629.  
  3630.        [ALT-S]   - Save the current menu to disk.
  3631.  
  3632.        [ALT-L]   - Discard  the present menu and load another  from
  3633.                    disk.
  3634.  
  3635.  
  3636.        Let's create the LOGOFF menu.  Hit RETURN on the first blank
  3637.        menu  item to bring up the EDIT MENU ITEM window.  The first
  3638.        line  of this menu will just display a message to the  user,
  3639.        so  in  the  USER DISPLAY field,  put "You  have  chosen  to
  3640.        disconnect.  You may -". Move to the ACTION field and set it
  3641.        to  DISPLAY  ONLY.  Next select a suitable  colour  for  the
  3642.        display  line  in  the COLOUR field.  Since this is  only  a
  3643.        display line,  leave SECURITY and FLAGS as they  are.  Press
  3644.        ESCAPE  to return to the menu list,  and note the entry  you
  3645.        have just created.
  3646.  
  3647.        Now enter the user options for the menu.  Move to the second
  3648.        menu  entry  (add one with the INSERT key if necessary)  and
  3649.        press  RETURN  to edit.  We'll give the user the  option  of
  3650.        leaving a message to the sysop, so in the USER DISPLAY field
  3651.        enter  "<L>eave a message to the sysop".  Set the ACTION  to
  3652.        POST  A NEW  MESSAGE (this is under the heading of  MESSAGE-
  3653.        BASE COMMANDS). This command requires a couple of parameters
  3654.        in the optional data field - the number of the message  area
  3655.        to  post the message in and the /T= parameter,  to force the
  3656.        message  to be addressed to the sysop.  It might  look  like
  3657.        this:
  3658.  
  3659.  
  3660.  
  3661.                                     57
  3662.        80 /T=Andrew_Milner
  3663.  
  3664.        (Message area 80 is set up as a "Messages to the sysop" area
  3665.        that  contains local private messages).  Set the HOT-KEY  to
  3666.        "L"  - this is the key that will activate the  function.  We
  3667.        want  all  users to be able to leave a message,  so set  the
  3668.        security level to 1.
  3669.  
  3670.        The  third  line of the menu gives the user  the  option  of
  3671.        returning  to  the previous menu,  so set this to a type  3,
  3672.        with a suitable display line.
  3673.  
  3674.        The  actual log-off command is last.  This will be a type  9
  3675.        (Terminate  Call).  Set the hot-key to "G" and  the  display
  3676.        line to something like "<G>oodbye (Logoff)".
  3677.  
  3678.        The  final step is to set the highlight and prompt  options.
  3679.        Press  ALT-P  from the menu list to bring up the  EDIT  MENU
  3680.        SETTINGS  window.  Here you can tailor the menu by selecting
  3681.        the  menu  prompt  and  its  colour,  along  with  the  menu
  3682.        highlight colour.  Each menu line,  in addition to it's  own
  3683.        colour,  may  contain an overall menu highlight  colour.  To
  3684.        switch between the two colours on a menu line, simply insert
  3685.        the  ^  character;  Note that this character isn't  actually
  3686.        displayed  to  the  user,   it  just  toggles  the  colours.
  3687.  
  3688.        Experiment with this feature by inserting a few ^ characters
  3689.        on display lines and viewing the menu with the ALT-D key.
  3690.  
  3691.        Finally,  save  the menu by going back to the menu list  and
  3692.        pressing  ALT-S.  Save the menu with the name  LOGOFF.  Now,
  3693.        whenever  you need a "Goodbye" option in another menu,  just
  3694.        use a gosub (type 2) function to the menu LOGOFF.
  3695.  
  3696.        There  is  one  hard-coded  menu  called  TOP.  RemoteAccess
  3697.        searches  for this menu when a user logs on and displays  it
  3698.        first,  so it MUST be present. The layout of the top menu is
  3699.        up to you of course;  it is recommended that you look at the
  3700.        menus of other Bulletin Boards so you can incorporate  their
  3701.        best features into your own.
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.                                     58
  3723.        EXTERNAL SUPPORT FILES   
  3724.        ────────────────────────────────────────────────────────────
  3725.                      
  3726.        There  is  very little that is  actually  "hard-coded"  into
  3727.        RemoteAccess. Below is a listing of text files you can place
  3728.        in  the  text  file directory to give your system  just  the
  3729.        right "feel". See the section on TEXT FILE CONTROL CODES for
  3730.        a  list  of special characters that can be used  to  display
  3731.        system  and user information from any of these files.  Files
  3732.        marked  with  an asterisk (*) have a default prompt  if  the
  3733.        file is missing. All the files are plain ASCII which you can
  3734.        create  with your favourite  text  editor/wordprocessor,  or
  3735.        optionally ANSI which you will need a special ANSI editor to
  3736.        create.
  3737.  
  3738.  
  3739.  
  3740.        1ATATIME.A?? :  This file is displayed if a user tries to   
  3741.         *              log  on to more than one line at once  if   
  3742.                        multi-line check has been enabled in        
  3743.                        RACONFIG.
  3744.  
  3745.        DNLDHRS.A??  :  This  file is  displayed  if a  user        
  3746.         *              attempts a download outside the  allowed    
  3747.                        hours as defined in RACONFIG.
  3748.  
  3749.        EDITHELP.A?? :  This  file is displayed if the user asks for
  3750.                        help   while  using  the  built-in   message
  3751.                        editor.  
  3752.         
  3753.        ENDCHT.A??   :  This file is displayed when the sysop       
  3754.         *              terminates chat mode.
  3755.  
  3756.        EXPIRED.A??  :  This file is displayed if the user's        
  3757.         *              password has just expired, just before the  
  3758.                        user is asked for a new password.
  3759.  
  3760.        GOODBYE.A??  :  This file is displayed when the  user elects
  3761.                        to   log  off,   just  before  the  user  is
  3762.                        disconnected.
  3763.  
  3764.        LOCKOUT.A??  :  This file is displayed if the sysop uses    
  3765.         *              ALT-L  while a user is on-line to  lock     
  3766.                        him/her out of the system.
  3767.  
  3768.        LOGO.ASC     :  This   file  is   displayed  as  soon  as  a
  3769.                        connection is made.  This should contain the
  3770.                        name  of your system and perhaps some  other
  3771.                        general information. 
  3772.  
  3773.        MAXPAGE.A??  :  This  file  is displayed  if a user tries to
  3774.         *              page  the sysop for a chat more  times  than
  3775.                        you have specified in RACONFIG.
  3776.  
  3777.        NEWS.A??     :  This file is a general news bulletin that is
  3778.                        displayed  after  RemoteAccess  checks   for
  3779.                        waiting mail (if the option is enabled),  or
  3780.                        straight after the WELCOME file.     
  3781.  
  3782.  
  3783.                                     59
  3784.        NEWUSER1.ASC :  This file is displayed to a new user as soon
  3785.                        as  he/she  confirms  that  he/she   entered
  3786.                        his/her name correctly.
  3787.  
  3788.  
  3789.  
  3790.        NEWUSER2.A?? :  This  file  is displayed after the user  has
  3791.                        confirmed  that   he/she  entered  all   the
  3792.                        standard logon questions correctly.
  3793.  
  3794.  
  3795.        NO300.ASC    :  This file is  displayed if a 300 baud caller
  3796.         *              attempts  to log  on during hours  when  300
  3797.                        baud   is   not  allowed,   as  defined   in
  3798.                        RACONFIG.
  3799.  
  3800.        NOCREDIT.A?? :  This  file is displayed if a caller attempts
  3801.         *              to  enter a netmail message for which he/she
  3802.                        does not have sufficient credit.
  3803.  
  3804.        NOTAVAIL.A?? :  This  file  is displayed  if a user tries to
  3805.         *              page  the  sysop for a chat  outside  paging
  3806.                        hours, as defined in RACONFIG.
  3807.  
  3808.        NOTFOUND.ASC :  This   file  is  displayed  if  RemoteAccess
  3809.         *              cannot  locate the name of a user at  logon,
  3810.                        but before the user is asked to confirm that
  3811.                        he/she entered the name correctly.
  3812.  
  3813.        NOTSYSOP.A?? :  This file is displayed if a user attempts to
  3814.         *              post  a  message to "Sysop" in  an  EchoMail
  3815.                        message area.
  3816.  
  3817.        PAGEABRT.A?? :  This  file is displayed if the sysop chooses
  3818.         *              to abort a page for chat by the user.
  3819.  
  3820.        PAGED.A??    :  This  file is  displayed  after the user has
  3821.                        paged  for  a  chat if the  sysop  does  not
  3822.                        answer the page.  Something like "Okay,  the
  3823.                        sysop has been paged and will break in for a
  3824.                        chat if he/she walks past."
  3825.  
  3826.        PASSWORD.A?? :  This  file  is displayed before the user  is
  3827.                        asked  to select a new password.  This  file
  3828.                        should  stress the importance of choosing  a
  3829.                        suitable password!
  3830.  
  3831.        PRIVATE.ASC  :  This file  is displayed  if a new user tries
  3832.         *              to log on to your system and you have set it
  3833.                        up as a private, pre-register BBS. 
  3834.  
  3835.        RATIO.A??    :  This  file is displayed if the user tries to
  3836.         *              do  a  download which would  exceed  his/her
  3837.                        ratio of number of files.
  3838.  
  3839.        RATIOK.A??   :  This  file is displayed if the user tries to
  3840.         *              do  a  download which would  exceed  his/her
  3841.                        ratio of K of uploads to K of downloads.
  3842.  
  3843.  
  3844.                                     60
  3845.        READHELP.A?? :  This  file is displayed if the user asks for
  3846.                        help while reading messages.
  3847.  
  3848.        SEC#.A??     :  These  files are  displayed  to users  of  a
  3849.                        particular security level directly after the
  3850.                        WELCOME file,  but before the mail check (if
  3851.                        enabled).     For    example,    the    file
  3852.                        SEC10.ASC/ANS,    if   present,   would   be
  3853.                        displayed  to all users with security  level
  3854.                        10. 
  3855.  
  3856.  
  3857.        STARTCHT.A?? :  This file is displayed when the sysop breaks
  3858.         *              in for a chat via ALT-C. Using the shell    
  3859.                        from textfile function this could           
  3860.                        conceivably be used to activate an external 
  3861.                        chat utility. See also ENDCHT.A??
  3862.  
  3863.  
  3864.        TIMEWARN.A?? :  This  file  is displayed  at log  on if  the
  3865.         *              user's  time  limit  has  been  adjusted  to
  3866.                        accomodate an upcoming event.
  3867.  
  3868.  
  3869.  
  3870.        TODAYK.A??   :  This  file is displayed if the user attempts
  3871.         *              a download which would exceed his/her  daily
  3872.                        download limit.
  3873.  
  3874.        TOOSLOW.ASC  :  This  file  is displayed if a user tries  to
  3875.         *              log  on  at a speed lower than  the  minimum
  3876.                        required to log on to your system as defined
  3877.                        in RACONFIG. 
  3878.  
  3879.        TRASHCAN.ASC :  This  file  is displayed if a user enters an
  3880.         *              unacceptable  name at log on,  as listed  in
  3881.                        the TRASHCAN.CTL file. 
  3882.  
  3883.        WELCOME.A??  :  This file is displayed after the user logged
  3884.                        on,  or  in the case of a  new  user,  after
  3885.                        completing the new user procedure.  This can
  3886.                        be  a  fairly  elaborate title  screen  that
  3887.                        welcomes your users to the BBS.
  3888.  
  3889.        WELCOME1.A?? :  This file is  displayed  directly after  the
  3890.                        WELCOME file, and could contain extra system
  3891.                        information,   maybe  a  "today  in history"
  3892.                        quote, or something similar.
  3893.  
  3894.        XFERHELP.A?? :  This file is displayed if the user presses  
  3895.                        the "?" key on the file transfer protocol   
  3896.                        selection menu. It should contain general   
  3897.                        information about the different protocols   
  3898.                        themselves.
  3899.  
  3900.        XFERTIME.A?? :  This  file is displayed if the user attempts
  3901.         *              a  download that would exceed his/her  daily
  3902.                        time limit.
  3903.  
  3904.  
  3905.                                     61
  3906.        In  addition to  these ASC/ANS files,  there are  also  four
  3907.        *.CTL  files  that  define various security aspects  of  the
  3908.        system:
  3909.  
  3910.          LIMITS.CTL  :  This  file  allows  you  specify,  for each
  3911.                        security  level,  a daily time  limit,  file
  3912.                        download  limit  for  each  baud  rate,  and
  3913.                        optional  file ratios,  either in number  of
  3914.                        uploads to number of downloads,  or in total
  3915.                        kilobytes   uploaded   to  total   kilobytes
  3916.                        downloaded.  The  format of the file  is  as
  3917.                        follows:
  3918.  
  3919.        <Sec Lvl> <Time> <300> [1200] [2400] [4800] [9600]
  3920.          or:
  3921.        <Sec Lvl> <Time> <300> <1200> <2400> <4800> <9600> <R#> [RK]
  3922.  
  3923.                        Where  <Sec  Lvl>  is  the  security  level,
  3924.                        <Time>  is  the daily time limit,  <300>  to
  3925.                        <9600>   are  respective   download   limits
  3926.                        depending  on what baud rate the user  calls
  3927.                        at.   <R#>   is  the  ratio  of  uploads  to
  3928.                        downloads,  and [RK] is the ratio of uploads
  3929.                        in K to downloads in K.
  3930.  
  3931.                        If you only specify a download limit for say
  3932.                        300, 1200 and 2400 baud, the download limits
  3933.                        for  the  higher baud rates default  to  the
  3934.                        highest  baud rate specified,  in this  case
  3935.                        the limit set for 2400 baud.
  3936.  
  3937.                        If you specify a ratio by number (R#) value,
  3938.                        then the user will be required to upload one
  3939.                        file for every n they  download.  Similarly,
  3940.                        setting  the ratio by K will allow the  user
  3941.                        to  download only the specified kilobytes of
  3942.                        files per 1 kilobyte uploaded.
  3943.  
  3944.                        This is fairly complicated,  so look at this
  3945.                        example LIMITS.CTL:  
  3946.  
  3947.                            5  35  0
  3948.                            10 60  100 200 350 650 900 5 10
  3949.                            20 90  150 250 470 750 900 5
  3950.                            30 120 250 400 600 900 1200
  3951.                            50 300 900
  3952.  
  3953.                        Security  level  5 entitles the user  to  35
  3954.                        minutes per day, but no downloads.
  3955.  
  3956.                        Security  level 10 entitles the user  to  60
  3957.                        minutes  per day,  100k of downloads at  300
  3958.                        baud,  200k at 1200 baud, 350k at 2400 baud,
  3959.                        650k at 4800 baud,  and 900k at 9600 baud or
  3960.                        faster. In addition, the user must upload at
  3961.                        least  one  file for every five  downloaded,
  3962.                        and may not download more than ten times the
  3963.                        total size of files uploaded.
  3964.  
  3965.  
  3966.                                     62
  3967.                        Security  level 20 entitles the user  to  90
  3968.                        minutes  per day,  150k of downloads at  300
  3969.                        baud,  250k at 1200 baud, 470k at 2400 baud,
  3970.                        750k  at 4800 baud and 900k at 9600 baud  or
  3971.                        faster.  In  addition,  the  user  may  only
  3972.                        download  five  times  the number  of  files
  3973.                        he/she uploaded.
  3974.  
  3975.                        Security  level 30 entitles the user to  120
  3976.                        minutes  per day,  250k of downloads at  300
  3977.                        baud,  400k at 1200 baud, 600k at 2400 baud,
  3978.                        900k at 4800 baud and 1,200k at 9600 baud or
  3979.                        faster. There are no ratio restrictions.
  3980.  
  3981.                        Security  level 50 entitles the user to  300
  3982.                        minutes  per day,  and 900k of downloads  at
  3983.                        all speeds without any ratio restrictions.
  3984.  
  3985.  
  3986.          PHONENUM.CTL : Use this file to  specify phone  numbers or
  3987.                         segments  of phone  numbers that you know  
  3988.                         to be false. A PHONENUM.CTL that contains:
  3989.  
  3990.                            00-
  3991.                            000-
  3992.                            -0000
  3993.  
  3994.                        Would  disallow  the numbers  "00-123-4567",
  3995.                        "000-123-4567",  "009-0000-1234".  The  rule
  3996.                        here  is that none of the specified  numbers
  3997.                        is  allowed to be imbedded anywhere  in  the
  3998.                        user's phone number.
  3999.  
  4000.          PWDTRASH.CTL : Allows you  to specify a list of  passwords
  4001.                        that  users  are not allowed  to  use.  This
  4002.                        could  contain  passwords  like  SECRET,  or
  4003.                        TEST.
  4004.  
  4005.          TRASHCAN.CTL : Allows you  specify  a list of  names  that
  4006.                        users may not use to log on to your  system.
  4007.                        In this file,  specify the undesirable names
  4008.                        one  per  line.  If for example you did  not
  4009.                        want  the names "Sysop",  "Jack  Daniels" or
  4010.                        "Superman"  used,  simply put the  following
  4011.                        lines in this file:
  4012.  
  4013.                            Sysop
  4014.                            Jack Daniels
  4015.                            Superman
  4016.  
  4017.                        The   tests  done  on  names  is  NOT  case-
  4018.                        sensitive, so the name "SYSOP" would also be
  4019.                        invalid. Names that contain any part of  the
  4020.                        names in the list are not allowed either.
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.                                     63
  4028.        THE USER FILE                    
  4029.        ────────────────────────────────────────────────────────────
  4030.  
  4031.        The  user file is possibly the most important single file on
  4032.        your BBS.  It contains all the information about each user's
  4033.        history, screen settings, and vital security data. Switch to
  4034.        your   system   directory   and  fire  up  USERED.EXE.  This
  4035.        utility  allows  you  to add,  modify or delete  any  user's
  4036.        record.  If  there are already some users in the  user-file,
  4037.        you will be presented with a list showing each user's  name,
  4038.        location and security level.  Select a user either by typing
  4039.        in the name, or moving the highlight bar to the entry on the
  4040.        screen and pressing RETURN.
  4041.  
  4042.        After  the  user is selected you will be presented with  the
  4043.        Edit Screen.  This lists the entire user's record which  can
  4044.        be modified and saved if you wish. 
  4045.  
  4046.        If  there  are no users already in the user-file,  the  Edit
  4047.        Screen will appear immediately for you to enter the  details
  4048.        of  the  first user.  Note that the only required  piece  of
  4049.        information (or "field") is the name,  and you can't proceed
  4050.        any further until you enter one.  You'll want to be included
  4051.        in  the  user file,  so enter your own name in  this  field.
  4052.  
  4053.        Next,  go  through  each of the other fields and  enter  the
  4054.        correct  details.  When finished,  press [CONTROL-ENTER]  to
  4055.        save  the information and then ESCAPE to exit.  If you don't
  4056.        want to save, just press ESCAPE by itself.
  4057.  
  4058.        To add a new user, simply press the INS key on the user list
  4059.        screen  and a blank record will be created for you to  edit.
  4060.  
  4061.        Deleting a user is accomplished by  moving the highlight bar
  4062.        to the user you want to delete and pressing the DEL  key.  A
  4063.        marker  will appear in the right hand column to signify that
  4064.        the  user is marked for deletion.  Note that the user  isn't
  4065.        actually  removed from the user file at  this  stage.  Users
  4066.        that have been marked for deletion are  removed  by  packing
  4067.        the user-file,  which should be  done  regularly  using  the
  4068.        utility RAUSER.
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.                                     64
  4089.        Packing and sorting the user file               
  4090.        ────────────────────────────────────────────────────────────
  4091.  
  4092.        RAUSER.EXE is the utility that is used to maintain the user-
  4093.        file.  Not only will it remove users marked for deletion, it
  4094.        can  also delete users that have not called your BBS  for  a
  4095.        certain number of days as well as sort the users in order of
  4096.        security  level  and surname.  RAUSER may be  run  from  any
  4097.        directory,  will automatically locate system and user files,
  4098.        and will insert an activity summary in your system log.  The
  4099.        following command-line parameters are valid:
  4100.  
  4101.  
  4102.             -P       Pack the user-file, removing users marked  for
  4103.                      deletion.
  4104.  
  4105.             -S       Sort users in  order  of  security  level  and
  4106.                      surname.
  4107.  
  4108.             -D[n]    Delete users who have not called for [n] days.
  4109.                      Note that this parameter implies a pack       
  4110.                      operation.
  4111.  
  4112.             -V       Verbose logging; list any users that were     
  4113.                      deleted during a pack operation.
  4114.  
  4115.             -M[s]    Specify the maximum security level user to be 
  4116.                      affected by a pack or delete operation. Put   
  4117.                      another way : "exempt all users with security 
  4118.                      level [s] and above from being deleted" .
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.                                     65
  4150.        THE MESSAGE DATABASE - RAMSG
  4151.        ────────────────────────────────────────────────────────────
  4152.  
  4153.        RAMSG is the RemoteAccess message  base maintenance utility.
  4154.        It's primary function is  to trim the number of  messages in
  4155.        local   and echomail conferences  and maintain them   at   a
  4156.        manageable   level. RACONFIG provides the  ability to enter,
  4157.        add  and  maintain     message  areas  -  RAMSG  uses   this
  4158.        information (contained in MESSAGES.RA)  to delete old and/or
  4159.        excess  messages.   RAMSG will   also   attempt   to  repair
  4160.        damaged  message bases, it has a  number of integrity checks
  4161.        built  in so that  if it detects  that the message  base  is
  4162.        damaged in  any way,  it will automatically  re-create index
  4163.        files  (even   if  they are  missing)  and warn  of possible
  4164.        problems.
  4165.  
  4166.        All of  RAMSG's activities are logged in  the  system  log. 
  4167.        Some options are provided for statistical information.
  4168.  
  4169.        Note that a value of 0 in any of  the fields on the  message
  4170.        area entry  screen in  RACONFIG will cause  RAMSG to  ignore
  4171.        that  option. For example, if the maximum number of messages
  4172.        is set  to 0, RAMSG will not  kill messages based on number.
  4173.        Prior running RAMSG, you should  ensure that all areas  have
  4174.        been set up correctly.
  4175.  
  4176.        RAMSG invoked  without a command line  results  in   a  help
  4177.        screen being displayed.
  4178.  
  4179.        When  one or more of the arguments below is specified, RAMSG
  4180.        searches  for CONFIG.RA  (first the current  directory, then
  4181.        via the  RA  environment  variable),  MESSAGES.RA  (in  the 
  4182.        current directory,  then the system directory)  and then the
  4183.        message base files.   Failure to  find one or more  of these
  4184.        files will result in  RAMSG aborting. If CONFIG.RA is  found
  4185.        and the system  log file can be  opened, RAMSG will  log any
  4186.        errors there.
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.                                     66
  4211.        Command summary
  4212.        ---------------
  4213.  
  4214.         -I Re-create index files & check
  4215.            C=Kill crosslinked messages
  4216.            U=Kill unknown boards
  4217.            R=Renumber
  4218.  
  4219.         -P Pack (compress) message base
  4220.            K=Purge 
  4221.            R=Renumber
  4222.            O=Overwrite
  4223.            A=Overwrite if necessary 
  4224.  
  4225.         -K Purge messages from info in MESSAGES.RA
  4226.  
  4227.         -L Link reply chains
  4228.  
  4229.         -R Renumber messages
  4230.  
  4231.         -S Display/log message base statistics
  4232.            All options:  S=Statistics  V=Verbose stats
  4233.  
  4234.  
  4235.  
  4236.  
  4237.        RAMSG functions (NOT case sensitive)
  4238.        ------------------------------------
  4239.  
  4240.                -I      INDEX [Options : C, R, U]
  4241.  
  4242.                        This  option  rebuilds  the  message  base  
  4243.                        index files, MSGIDX.BBS, MSGTOIDX.BBS and   
  4244.                        MSGINFO.BBS. It also  checks the integrity  
  4245.                        of all message base files and rebuilds other
  4246.                        information as necessary. Errors in the     
  4247.                        message base are logged.
  4248.  
  4249.                        During the  index  rebuild,  you  may       
  4250.                        choose to delete  messages  from  unknown   
  4251.                        message areas (those areas which have no    
  4252.                        entry in the name field)  and  messages with
  4253.                        message board numbers outside the valid     
  4254.                        range of 1-200.
  4255.  
  4256.                        Under  some  circumstances  RAMSG  may      
  4257.                        detect  a "sequence error" (when numbers are
  4258.                        out of order). Since  this  causes          
  4259.                        significant problems with software using the
  4260.                        message base, RAMSG  considers this serious,
  4261.                        and therefore will not  proceed with  any   
  4262.                        operation  other  than  an  index  rebuild  
  4263.                        until this is corrected using the "R"       
  4264.                        option, to force message base renumbering.
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.                                     67
  4272.                        "Crosslinking" of message text is also      
  4273.                        considered a serious problem, and this  will
  4274.                        prevent  RAMSG  repacking the message base. 
  4275.                        Cross-linking occurs when more than one     
  4276.                        message  references  the  same section of   
  4277.                        text in MSGTXT.BBS.
  4278.  
  4279.                        Following are some examples  of  what  an   
  4280.                        index rebuild command might look like:
  4281.  
  4282.                        RAMSG -Icu
  4283.  
  4284.                        Rebuild indices, kill messages in  unknown  
  4285.                        areas and crosslinked messages.
  4286.  
  4287.                        RAMSG -I
  4288.  
  4289.                        Rebuild index files only.
  4290.  
  4291.  
  4292.                -P      PACK  [options : K, R, O, A]
  4293.                
  4294.                        Packs  the  message  base,  by  eliminating 
  4295.                        all deleted  messages  and  message  text.  
  4296.                        Deleting (the -K option, for example)       
  4297.                        messages does not remove them from the      
  4298.                        message base files, it simply marks them for
  4299.                        deletion. You  MUST  pack the message base  
  4300.                        to reclaim the space occupied by these      
  4301.                        deleted messages.
  4302.  
  4303.                        PACK also provides options  to  purge       
  4304.                        old/excess messages (same as -K, except     
  4305.                        that  -K  does  not  pack) and renumber     
  4306.                        (same as -R), so all  standard              
  4307.                        maintenance functions can be carried out  in
  4308.                        the one command.
  4309.                        
  4310.                        RAMSG normally packs the message base by    
  4311.                        copying messages from the existing          
  4312.                        message base into temporary files,          
  4313.                        deleting the original files, then           
  4314.                        renaming the temporary files to their       
  4315.                        correct names.  This is the safest option to
  4316.                        use, since it is possible to rebuild the    
  4317.                        message base if for any reason the PACK     
  4318.                        process is interrupted (for example, by     
  4319.                        power failure). However, this requires that 
  4320.                        at least as much space as occupied by the   
  4321.                        old message base files be free on your hard 
  4322.                        disk.                            
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.                                     68
  4333.                        To get around this, RAMSG provides an       
  4334.                        option to pack the message base "on top" of 
  4335.                        the existing one without using temporary    
  4336.                        files.  This directly overwrites the        
  4337.                        existing files; and the problem with this is
  4338.                        that if the process is  interrupted, the    
  4339.                        message base may be irreparably  damaged    
  4340.                        and data could be lost.  To use overwrite   
  4341.                        mode, RAMSG requires the 'o' option in the  
  4342.                        PACK command; this forces overwriting       
  4343.                        unconditionally. To ensure that the message 
  4344.                        base is processed, while  taking advantage  
  4345.                        of  a  safer  environment,  RAMSG  also     
  4346.                        provides an 'a' option, which will use      
  4347.                        overwrite mode only if there is insufficient
  4348.                        space for a regular pack.
  4349.  
  4350.                        Examples:
  4351.  
  4352.                        RAMSG -Pkra
  4353.  
  4354.                        Pack the message base, kill messages        
  4355.                        according to information in MESSAGES.RA,    
  4356.                        renumber messages and use overwrite  mode   
  4357.                        only if insufficient disk space for a       
  4358.                        regular pack.
  4359.  
  4360.                        RAMSG -Po
  4361.  
  4362.                        Pack the message base, using overwrite mode.
  4363.  
  4364.  
  4365.                -K      Purge messages
  4366.  
  4367.                        This option  purges  messages  according  to
  4368.                        the maximum number of messages and aging    
  4369.                        information specified for each area in      
  4370.                        MESSAGES.RA. Note that the messages are not 
  4371.                        actually removed, they are simply marked for
  4372.                        deletion. Use the pack command to reclaim   
  4373.                        the space that these messages occupy.
  4374.  
  4375.  
  4376.                -L      Link reply chains
  4377.  
  4378.                        Links  reply  chains  in  each  area   (this
  4379.                        is automatically done by other maintenance  
  4380.                        functions where necessary). You would use   
  4381.                        this option by itself after an import by    
  4382.                        your echomail processor, for example.
  4383.  
  4384.  
  4385.                -R      Renumber messages
  4386.  
  4387.                        Renumbers the message base.  This option may
  4388.                        also be used to cure "out of sequence"      
  4389.                        errors.
  4390.  
  4391.  
  4392.  
  4393.                                     69
  4394.                -S      Display/log message base statistics
  4395.  
  4396.                        Simply logs message base and disk statistics
  4397.                        for your own information. A 'v' after this  
  4398.                        option displays verbose statistics for each 
  4399.                        message area.
  4400.  
  4401.  
  4402.        You may  run several  operations on  the same  command line,
  4403.        but since there is  some overlap in functionality,  the need
  4404.        to do  this is rare.   One instance of where  you might need
  4405.        this  facility  is  to force the message base to  be "clean"
  4406.        prior running a pack; for example:
  4407.  
  4408.                RAMSG -Icur -Pkra
  4409.  
  4410.        Checks/rebuilds index files, deleting messages in unknown   
  4411.        areas, fixes cross-linked messages and forces a  renumber   
  4412.        to fix sequence errors.  It then will proceed to pack and   
  4413.        renumber the message base  after  killing  excess/expired   
  4414.        messages using overwrite mode if required.
  4415.  
  4416.  
  4417.        Several errorlevel  exits are provided to  allow  management
  4418.        by batch file:
  4419.  
  4420.                1       No arguments specified; help message given. 
  4421.                2       Cannot access/locate CONFIG.RA
  4422.                3       Out of or insufficient memory
  4423.                4       Error opening/locating a file
  4424.                5       Serious IO error
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.                                     70
  4455.        MAIL NETWORKING 
  4456.        ────────────────────────────────────────────────────────────
  4457.                     
  4458.        What  is a mail network?  Basically it is a set of  bulletin
  4459.        board  systems  that are capable of exchanging messages  and
  4460.        files   with   each  other  without  the  need   for   human
  4461.        intervention.  All  the discussion which follows relates  to
  4462.        FidoNet,  the world's largest amateur mail network.  FidoNet
  4463.        consists of approximately 5,000 bulletin board systems, each
  4464.        of  which is assigned a unique "address".  A file  called  a
  4465.        nodelist   stores  all  these  addresses  along  with  other
  4466.        information  about  each  system.   Think  of  it  like   an
  4467.        international "telephone book".
  4468.  
  4469.        Being  part of a network has two basic attractions;  NetMail
  4470.        and EchoMail.  NetMail allows you to send a private  message
  4471.        to  any  user  of  any one of the bulletins  boards  in  the
  4472.        network at little or no cost to you. EchoMail is a method of
  4473.        creating  a huge message area that many hundreds of  systems
  4474.        can potentially participate in.  Usually all EchoMail  areas
  4475.        will  contain only public messages,  and are organised  into
  4476.        either  general  discussion areas,  or areas that deal  with
  4477.        specific issues and or topics.
  4478.  
  4479.        The net is organised into several levels,  which are usually
  4480.        based on geographical proximity.  At the highest level there
  4481.        are five "zones";  zone 1 is the USA, zone 2 is Europe, zone
  4482.        3 is the Pacific Rim,  zone 4 is South America and zone 5 is
  4483.        Africa. Within each zone are a number of "regions" that span
  4484.        large geographical areas.  Typically there will be between 5
  4485.        and 18 regions per zone. Each region is further divided into
  4486.        "nets".   Each  net  has  a  unique  net  number,   and  the
  4487.        distribution of these nets is also based on geographical and
  4488.        technical  considerations.  Finally,  within  the net are  a
  4489.        number  of nodes.  A node refers to a single bulletin  board
  4490.        system. 
  4491.  
  4492.        To find out about obtaining a node number,  or an "address",
  4493.        contact  the nearest FidoNet bulletin board.  The sysop will
  4494.        usually be more than happy to help you out.
  4495.  
  4496.        Before  going  any  further,  let's  talk  about  the  extra
  4497.        software you will need to set up as a node. Firstly you will
  4498.        need  an  echomail  processor.  This is  the  program  which
  4499.        unpacks the mail you will receive,  and imports it into your
  4500.        RemoteAccess  message-base,  as well as packing up  outbound
  4501.        mail  that  needs  to be sent  out.  RemoteAccess  does  NOT
  4502.        include  such  a beast.  There are several other  processors
  4503.        around that will do the job:
  4504.  
  4505.             Echogen and QEcho, both by Adam Hudson,
  4506.             ZMailQ, by Claude N. Warren,
  4507.             TosScan, by Joaquim Homrighausen.
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.                                     71
  4516.        The  last  two  are commercial  products,  and  require  the
  4517.        payment of a small fee to purchase them.  Echogen and  QEcho
  4518.        are shareware,  and as such require no initial payment,  but
  4519.        they  both  have KNOWN bugs,  although both are still  fully
  4520.        functional.
  4521.  
  4522.        The  other  piece  of  software you'll  need  is  a  mailer.
  4523.        RemoteAccess  will  not  directly  communicate  with   other
  4524.        network  bulletin  boards,  so a separate program fills  the
  4525.        gap. The two recommended mailers are:
  4526.  
  4527.             FrontDoor, by Joaquim Homrighausen,
  4528.             D'Bridge, by Chris Irwin.
  4529.             BinkleyTerm, by Bit Bucket Software.
  4530.  
  4531.        All of these  products are available  on a shareware  basis,
  4532.        and  like  the  echomail processors,    will    usually   be
  4533.        available   on  most  FidoNet bulletin boards if you ask the
  4534.        sysop nicely enough.
  4535.  
  4536.        The  node  number  you are assigned will be  of  the  format
  4537.        Zone:Net/Node.Point.  This initial node number should be put
  4538.        into  your  configuration file using the ADDRESS  option  of
  4539.        RACONFIG. Don't worry about the AKA addresses at this stage.
  4540.  
  4541.        The next step is to set up your EchoMail message areas.  You
  4542.        will  usually be given a list of areas that are available to
  4543.        you.  Each  area is identified by an uppercase  alphanumeric
  4544.        name. As far as RemoteAccess is concerned, all you need is a
  4545.        description  of each area you plan to "plug into".  Fire  up
  4546.        RACONFIG,  and  go to the MESSAGE AREAS  window.  Select  an
  4547.        unused  message area,  and enter the area's name in the NAME
  4548.        field.  Next,  set the TYPE OF MAIL field to  ECHOMAIL,  and
  4549.        MESSAGE  STATUS to PUBLIC.  Most EchoMail areas don't  allow
  4550.        the  use of aliases,  so set this to "No".  The AKA  ADDRESS
  4551.        line shows  your assigned node number.  If it  doesn't,  hit
  4552.        RETURN on this option and select the correct address.
  4553.  
  4554.        Each  EchoMail message  that is posted on your system  could
  4555.        potentially be read by hundred of other sysops and users, so
  4556.        you can put a "one-liner" at the end of each message. In the
  4557.        ORIGIN LINE field enter a short message. This should contain
  4558.        at least the name of your system,  and possibly where it  is
  4559.        or the phone-number, so that other users know where to call.
  4560.        Your node number is also appended to the end of the message,
  4561.        so a typical origin line might read:
  4562.  
  4563.             * Origin : RemoteAccess HQ (3:690/625.0)
  4564.  
  4565.        Don't  put  the "* Origin" part in - this is added  by  the 
  4566.        software).  If  you  don't  specify an  origin  line  for  a
  4567.        particular  area,  RemoteAccess will use the DEFAULT  ORIGIN
  4568.        LINE.
  4569.  
  4570.        If running a  multi-node system,  the line  number that  the
  4571.        message was posted on may be inserted in the origin  line by
  4572.        using the '@' macro character in any origin line definition.
  4573.  
  4574.  
  4575.  
  4576.                                     72
  4577.        The  next  step  is to configure RemoteAccess  for  NetMail.
  4578.        Select another unused message area,  and call it  "NetMail",
  4579.        or something similar. Next, set the TYPE OF MAIL to NETMAIL,
  4580.        and  MESSAGE STATUS to PRIVATE.  NetMail messages don't have
  4581.        origin lines appended to them so leave the origin line entry
  4582.        blank.  RemoteAccess  incorporates  a  comprehensive  online
  4583.        nodelist browsing facility, which allows users to search for
  4584.        nodes  in particular zones,  regions or  nets.  The  section
  4585.        INSTALLING  NODELIST  FILES  explains  how  to  enable  this
  4586.        feature.
  4587.  
  4588.        That's it!  RemoteAccess is now fully configured for network
  4589.        mail.  Assuming that you have a suitable mailer and echomail
  4590.        processor,  all that is required is to set them up correctly
  4591.        and you're in business.  An explanation of setting these  up
  4592.        is beyond the scope of this document,  full instructions are
  4593.        available with each respective package.
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.                                     73
  4638.        Installing the nodelist files 
  4639.        ────────────────────────────────────────────────────────────
  4640.  
  4641.        Most  other BBS software requires you to maintain large  and
  4642.        unwieldy   custom  nodelist  files  for  NetMail  operation.
  4643.        RemoteAccess  uses the "raw" (St.  Louis) nodelist that  you
  4644.        already  have for your front-end mailer,  in addition  to  a
  4645.        small  (around 5K) index file.  The key to the system is the
  4646.        nodelist index compiler (RANODE.EXE). You should adjust your
  4647.        batch files so it is run every time any changes are made  to
  4648.        your  raw nodelist (when you receive a NODEDIFF update,  for
  4649.        example).  RANODE can be run from any directory, and locates
  4650.        your raw nodelist via the NODELIST PATH defined in RACONFIG.
  4651.  
  4652.        It  scans the most recent nodelist present and produces  the
  4653.        index     files    (NODEIDX.RA  and NODEINC.RA)  in    your 
  4654.        RemoteAccess     system directory.   If   you  have multiple
  4655.        nodelists  to process,    simply specify  the  names of  any
  4656.        additional  nodelists  on  the command-line  when  RANODE is
  4657.        executed.  
  4658.  
  4659.        Example  :  Compiling  a  FidoNet  nodelist  only.  The  raw
  4660.        nodelist  is in the C:\NODELIST directory.  Simply set  your
  4661.        NODELIST  PATH  in RACONFIG to C:\NODELIST,  and run  RANODE
  4662.        whenever you process  a nodediff,  without any  command-line
  4663.        parameters.
  4664.  
  4665.        Example : Compiling a FidoNet and ParaNet combined nodelist.
  4666.        The  FidoNet  NODELIST.nnn  and  ParaNet  PARALIST.PVT   raw
  4667.        nodelist  files  are in C:\NODELIST. Simply run  RANODE with
  4668.        the following parameter:
  4669.  
  4670.             RANODE PARALIST.PVT
  4671.  
  4672.        Up  to ten  nodelists  (including the  FidoNet  one) may  be
  4673.        specified -  wildcards and pattern  matching characters  are
  4674.        valid.
  4675.  
  4676.        Note that  it  is  not  necessary  to  specify  the  FidoNet
  4677.        NODELIST.nnn  as well,  as RANODE  includes the  most recent
  4678.        FidoNet nodelist automatically.
  4679.  
  4680.  
  4681.        In  order to control the volume of netmail your users  send,
  4682.        each user has a "netmail credit" field in his or her record.
  4683.        RemoteAccess   will  give  all  new  users  a  credit  limit
  4684.        based  on  the NEW USER NETMAIL CREDIT setting in  RACONFIG.
  4685.  
  4686.        You  define  the  cost  of sending a  single  message  to  a
  4687.        particular node in a control file called NODECOST.CTL  which
  4688.        is located in the RemoteAccess system directory. Each time a
  4689.        user sends a netmail message, it's cost is deducted from his
  4690.        or her account.
  4691.  
  4692.        The cost structure for your entire nodelist is set up by one
  4693.        or more entries of four keywords:
  4694.  
  4695.  
  4696.  
  4697.  
  4698.                                     74
  4699.        DEFAULT <cost>
  4700.  
  4701.        Assigns <cost> to any nodes that are not assigned a specific
  4702.        cost later on in the control file.
  4703.  
  4704.  
  4705.  
  4706.        ZONE <zone> <cost>
  4707.  
  4708.        Assigns  <cost> to all nodes in <zone>.  This overrides  the
  4709.        DEFAULT keyword.
  4710.  
  4711.  
  4712.  
  4713.        REGION <region> <cost>
  4714.  
  4715.        Assigns <cost> to all nodes in <region>.  This overrides the
  4716.        DEFAULT and ZONE keywords.
  4717.  
  4718.  
  4719.  
  4720.        NET <net> <cost>
  4721.  
  4722.        Assigns  <cost>  to all nodes in <net>.  This overrides  the
  4723.        DEFAULT, ZONE and REGION keywords.
  4724.  
  4725.  
  4726.  
  4727.        Sample NODECOST.CTL:
  4728.  
  4729.        DEFAULT 200       ; A message to anywhere costs 200 cents,
  4730.        ZONE      3   60  ; except in zone 3, which costs 60 cents.
  4731.        ZONE      2  260  ; Messages to zone 2 cost a bit more,   
  4732.        REGION   55   30  ; Within our region only costs 30 cents.
  4733.        NET     690    0  ; Msgs within our net are free.
  4734.  
  4735.  
  4736.        The  control  file may contain a maximum of 150  entries  of
  4737.        each  keyword,  and  duplicate  entries  are  obviously  not
  4738.        permitted.
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.                                     75
  4760.        MULTI - NODE OPERATION
  4761.        ────────────────────────────────────────────────────────────
  4762.  
  4763.        It  is  assumed  that  you have some  knowledge  of  running
  4764.        RemoteAccess already, or have at least run a single line BBS
  4765.        for some time.  If you haven't,  it is strongly  recommended
  4766.        that   you run one line  for a little while  to  familiarise
  4767.        yourself with the terminology and operation of RemoteAccess.
  4768.  
  4769.        The  idea of multi-node operation is that more than one user
  4770.        can be on-line at the same time to the same BBS.  To do this
  4771.        safely,  it  is  necessary for RemoteAccess  to  manage  the
  4772.        configuration   and  data  files  it  uses  very  carefully.
  4773.  
  4774.        Firstly,  tell RemoteAccess that it's running in  multi-node
  4775.        mode  by setting the MULTI LINE option to "Yes" in RACONFIG.
  4776.        You  should  also set CHECK FOR MULTI LOGON  to  "Yes".  Not
  4777.        doing this can cause unpredictable  results when a user logs
  4778.        on to more than one line at once.
  4779.  
  4780.        Set the  SYSTEM LOG NAME to  "RA.LOG". Make sure you  do NOT
  4781.        specify a full path with the name.
  4782.  
  4783.        Next create one child directory of your system directory for
  4784.        each line you intend to operate. For example, assuming  that
  4785.        the  system  directory  is   C:\RA,  for  two  lines  create
  4786.        C:\RA\LINE1 and C:\RA\LINE2 (the actual directory  names are
  4787.        not important).
  4788.  
  4789.        At  this  stage, ensure  that  the  RA environment  variable
  4790.        points to the system  directory so each line will be able to
  4791.        locate the configuration files.
  4792.  
  4793.        Why  separate directories? Many  on-line utilities and doors
  4794.        are not  multi-node aware,  so they  must  be isolated  from
  4795.        themselves in the  event that more than one copy of the same
  4796.        door is executed at the same  time. Thus it may be necessary
  4797.        to place  extra configuration files  for some doors  in each
  4798.        line directory. 
  4799.  
  4800.        For example, to install QuickEd in a multi-node environment,
  4801.        ensure that QUICKED.EXE is in the system directory (C:\RA in
  4802.        this  example)  and  that  the EXTERNAL  EDITOR  setting  in
  4803.        RACONFIG  is set  to  "C:\RA\QUICKED.EXE".  To complete  the
  4804.        installation, copy  the  files QUICKED.HLP  and  QUICKED.CFG
  4805.        into  each  line  directory; these  two  files  need not  be
  4806.        present in the system directory.
  4807.  
  4808.        All that is necessary now is to  create the batch files that
  4809.        call each copy of RA for each line:
  4810.  
  4811.        REM Sample batch file to fire up line 1
  4812.        :START
  4813.          CD \RA\LINE1
  4814.          RA -N1
  4815.          REM Check errorlevels etc
  4816.          GOTO START
  4817.  
  4818.  
  4819.  
  4820.                                     76
  4821.        Note  that   the  -N1   parameter  is  not   required  since
  4822.        RemoteAccess defaults  to line 1;  it is  included only  for
  4823.        completeness.
  4824.  
  4825.        REM Sample batch file to fire up line 2, using FrontDoor 
  4826.        REM as a front-end mailer in shell to mailer mode
  4827.        :START
  4828.          CD \RA\LINE2
  4829.          RA -M\FD\FD.EXE*M -N2
  4830.          REM Check errorlevels etc
  4831.          GOTO START
  4832.  
  4833.        RemoteAccess will  keep a  separate system log  (RA.LOG) and
  4834.        usage graph file (TIMELOG.BBS) in each line directory.
  4835.  
  4836.        The  placement  of the EXITINFO.BBS  and  DORINFO1.DEF  door
  4837.        files is handled differently in a multi-node environment. In
  4838.        a  single  line installation these files are written to  the
  4839.        RemoteAccess system directory.  In multi-node mode they  are
  4840.        written  to the current  (default) directory,  thus ensuring
  4841.        that each door has it's  own set of info files from  the BBS
  4842.        at all times.
  4843.  
  4844.        Additional  configuration  flexibility  is  provided  in the
  4845.        method RemoteAccess uses to locate  the configuration (*.RA)
  4846.        files. If one or more of the *.RA config files is present in
  4847.        a particular  line directory, then the  information in those
  4848.        files  will  override  the   information  contained  in  the
  4849.        corresponding config file in the system directory.
  4850.  
  4851.        For  example, it  may  be necessary  for  each line  to  use
  4852.        different  modem  configuration  information. This  data  is
  4853.        contained in CONFIG.RA, so make a copy of  this file in each
  4854.        line  directory.  Change to  the  line 1  directory  and use
  4855.        RACONFIG to edit the  modem settings. Save your changes  and
  4856.        repeat the procedure for line 2. When RemoteAccess fires up,
  4857.        it  will use the CONFIG.RA in the current directory that you
  4858.        just edited,  and  the  other  config files  in  the  system
  4859.        directory.
  4860.  
  4861.        The  LIMITS.CTL file works in the same way; you may override
  4862.        the global settings in the system directory by making a copy
  4863.        of LIMITS.CTL in  one or more  line directories and  editing
  4864.        with an ASCII text editor. This enables each line to exhibit
  4865.        different  download  and  time  limits  for  one  particular
  4866.        security level.
  4867.  
  4868.        Beware  of  third party utilities that write to  the  system
  4869.        files!  RemoteAccess  is specifically written so  that  many
  4870.        users  can read and post messages simultaneously to the same
  4871.        message-base,  but other programs probably AREN'T. Check the
  4872.        documentation  very  carefully  before  you  fire  up   your
  4873.        favourite  off-line  mail editor and start posting  messages
  4874.        while someone else is on-line.  Similarly,  if your echomail
  4875.        processor  does  not  lock  the  message-base  files   while
  4876.        working,  you  should set up your system to ensure that mail
  4877.        is  never imported when there is a user  on-line.  Exporting
  4878.        messages however, IS permitted.
  4879.  
  4880.  
  4881.                                     77
  4882.        It's  quite  likely that you'll need to increase  the  FILES
  4883.        setting  in  your  CONFIG.SYS  if  RemoteAccess  is  running
  4884.        several  lines  under  a multitasker.  You'll  also  need  a
  4885.        separate  batch-file  for each line to  invoke  RemoteAccess
  4886.        with the correct command-line parameters.  See the reference
  4887.        section on command-line parameters for information on the -N
  4888.        parameter.
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.  
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.                                     78
  4943.        REFERENCE SECTION            
  4944.        ────────────────────────────────────────────────────────────
  4945.  
  4946.  
  4947.  
  4948.        Sysop keys                     
  4949.        ────────────────────────────────────────────────────────────
  4950.  
  4951.        The following keys work while a user is on-line:
  4952.  
  4953.  
  4954.        [F1] [F2]    : Comprehensive user statistics on an optional 
  4955.        [F3] [F5]      two-line  status  bar at the bottom  of  the 
  4956.                       screen.
  4957.  
  4958.        [F4]         : System statistics. This is the default status
  4959.                       bar  that is displayed when  RemoteAccess  is
  4960.                       waiting for a call.
  4961.  
  4962.        [F9]         : Help! Hot-key summary.
  4963.  
  4964.        [F10]        : Turn off the status bar, to show exactly what
  4965.                       the  user is seeing.  [F1] to [F5] brings  it
  4966.                       back.
  4967.  
  4968.        [ALT-Fn]     : Activate  one of ten programs in a shell,  or
  4969.                       exit to DOS at a certain errorlevel.
  4970.  
  4971.        [ALT-C]      : Break  in for  a chat  if there is a user  on
  4972.                       remotely.  ESC  finishes chat mode and  drops
  4973.                       the user back to the BBS.
  4974.  
  4975.        [CTL-A]      : Opens  and  closes a  capture file  during  a
  4976.                       chat session.
  4977.  
  4978.        [ALT-D]      : Toggles  "Snoop" mode,  ie. whether the local
  4979.                       screen shows what the user is doing.
  4980.  
  4981.        [ALT-E]      : Activates a pop-up user attribute editor     
  4982.                       for the user currently online. 
  4983.  
  4984.        [ALT-H]      : Hang up on the user immediately.
  4985.  
  4986.        [ALT-J]      : Drop to a DOS shell while the user is  still 
  4987.                       on-line.
  4988.  
  4989.        [ALT-L]      : Lock  the  user out of the system by dropping
  4990.                       his/her  security level to zero  and  hanging
  4991.                       up.  
  4992.  
  4993.        [ALT-P]      : Toggle printer logging.
  4994.  
  4995.        [ALT-O]      : Override  paging  hours.  This allows you  to
  4996.                       enable or disable sysop paging regardless  of
  4997.                       the  time.  Note that this is permanent,  and
  4998.                       affects all lines until reset.
  4999.  
  5000.        [ALT-S]      : Modify the current user's security level.
  5001.  
  5002.  
  5003.                                     79
  5004.        [Up-Arrow]   : Increase the user's time by one minute.
  5005.  
  5006.        [Down-Arrow] : Decrease the user's time by one minute.
  5007.  
  5008.  
  5009.  
  5010.        When  the system is waiting for a call,  the only sysop  key
  5011.        that is active is [ALT-O],  however, pressing [L] will allow
  5012.        you to log-on locally,  and [ESC] will terminate the program
  5013.        and  return to DOS.  Note that terminating in this way  will
  5014.        always  return  an  errorlevel  of 0 to  DOS  regardless  of
  5015.        whether the -E command-line parameter is invoked.
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.                                     80
  5065.        Command-line parameters 
  5066.        ────────────────────────────────────────────────────────────
  5067.  
  5068.        RemoteAccess accepts the following command-line parameters:
  5069.                     
  5070.        -NOEMS  : Forces RemoteAccess to ignore any available EMS.
  5071.  
  5072.        -Kpwd   : Lock the local keyboard with a password. The      
  5073.             {+}  password must be correctly entered prior to using 
  5074.                  any ALT-key.
  5075.  
  5076.        -L      : Run RemoteAccess in local mode.
  5077.        -S      : Set "snoop" mode off; disable local screen.
  5078.        -D      : Disable status bar by default.
  5079.        -R      : Log user back on-line after a menu type 15 exit.
  5080.        -P      : Log user activity to printer.
  5081.        -Nxx    : Line (node) number in a multi-line system (1-99).
  5082.        -Cx     : Communications port to use (1-4).
  5083.        -Bxxxxx : Log user on-line at baudrate xxxxx.
  5084.        -Exxx   : Exit at errorlevel xxx after caller logs off.
  5085.        -Txxx   : Time (in minutes) until next system event.
  5086.  
  5087.                  NOTE: Some mailers have the capability to generate
  5088.                  a "standard format" batch file called DOBBS.BAT to
  5089.                  run the BBS program. In shell-to-mailer mode (see 
  5090.                  below) RemoteAccess will scan this batch file (if 
  5091.                  present) to determine the time until the next     
  5092.                  event.
  5093.  
  5094.        -M<f>   : Activate  the "shell to  mailer"  feature.  This 
  5095.                  causes RemoteAccess, upon loading, to execute your
  5096.                  front-end mailer program in a DOS shell.  When the
  5097.                  mailer exits,  RemoteAccess detects the errorlevel
  5098.                  it  would normally pass to the batch-file.  If the
  5099.                  errorlevel  matches one defined in  RACONFIG,  the
  5100.                  user  is logged on to the BBS at  the  appropriate
  5101.                  baud rate.  If the errorlevel is not recognised as
  5102.                  an  incoming  call,  RemoteAccess   exits  to  its
  5103.                  batch-file at that errorlevel.  See the BATCH FILE
  5104.                  EXAMPLES section for more on this feature.
  5105.  
  5106.                  NOTE:  RemoteAccess  does  the swap by  storing  a
  5107.                  "swap  file"  in EMS (if available) and  on  disk.
  5108.                  Normally  this file would be stored in  the system
  5109.                  directory,   but   it   is   possible   to   force
  5110.                  RemoteAccess  to  put the file in a  directory  of
  5111.                  your  choice  by setting  the  RATEMP  environment
  5112.                  variable.  For  example,  if you executed the  DOS
  5113.                  command SET RATEMP=E:\TEMP\STORAGE,  then the swap
  5114.                  file   would  be  placed  in  the  E:\TEMP\STORAGE
  5115.                  directory.
  5116.  
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.                                     81
  5126.                  In "shell to mailer" mode,  it is possible for two
  5127.                  errorlevels to conflict. For example, errorlevel 5
  5128.                  is used by RA to indicate that a user entered both
  5129.                  net  and  echomail,  and by FrontDoor to  indicate
  5130.                  modem initialise failure. If the front-end returns
  5131.                  an   errorlevel  that  conflicts  in   this   way,
  5132.                  RemoteAccess  will  pass  to the batch  file  that
  5133.                  errorlevel  plus 10.  So,  if  FrontDoor  returned
  5134.                  errorlevel   5   because  the  modem   would   not
  5135.                  initialise,  RemoteAccess would pass errorlevel 15
  5136.                  to the batch file. 
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.                                     82
  5187.        Errorlevels                 
  5188.        ────────────────────────────────────────────────────────────
  5189.  
  5190.        When  RemoteAccess exits to DOS either after a user logs off
  5191.        or  because  of  a menu type 15 "Exit to  DOS"  function  it
  5192.        returns  an errorlevel that your batchfile should  test  for
  5193.        and act on accordingly:
  5194.  
  5195.        Errorlevel  Meaning
  5196.        ----------  -------
  5197.            0       User logged off OK,  default value.  Note - this
  5198.                    can  be  overridden  with the  -E  command  line
  5199.                    parameter. 
  5200.  
  5201.            1       Initialisation error - couldn't  find the FOSSIL
  5202.                    driver, or the modem failed to initialise.
  5203.  
  5204.            2       Special error condition;  used for Beta versions
  5205.                    only.
  5206.  
  5207.            3       The  user  entered one or more NetMail  messages
  5208.                    during the session.  The message base should  be
  5209.                    scanned for outgoing NetMail.
  5210.  
  5211.            4       The  user entered one or more EchoMail  messages
  5212.                    during  the session.  The message base should be
  5213.                    scanned for outgoing EchoMail.
  5214.  
  5215.            5       Both NetMail AND EchoMail messages were entered.
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.                                     83
  5248.        Text file control codes                                   
  5249.        ────────────────────────────────────────────────────────────
  5250.  
  5251.        There are a range of special control characters that can  be
  5252.        inserted  in any of your ASCII/ANSI files that cause certain
  5253.        system and user information to be displayed. There are three
  5254.        classes of codes.  Each code is a two-character  combination
  5255.        of a control-code followed by by a normal character:
  5256.  
  5257.                 Character
  5258.        ASCII#   Combination  Purpose
  5259.        ------   -----------  --------------------------------------
  5260.        01         ^A         Wait until the [Return] key is pressed
  5261.        02         ^B         Disable aborting with the "S" key
  5262.        03         ^C         Enable aborting with the "S" key
  5263.        04         ^D         Enable the "Continue?" prompt
  5264.        05         ^E         Disable the "Continue?" prompt
  5265.        06         ^F       * Insert a user parameter 
  5266.        07         ^G         Produce a beep on the caller's console
  5267.        08         ^H         Backspace
  5268.        09         ^I         Tab (forward 8 characters)
  5269.        10         ^J         Linefeed
  5270.        11         ^K       * Insert a system parameter
  5271.        12         ^L         Clear screen
  5272.        13         ^M         Carriage return
  5273.        17         ^Q         RESERVED FOR XON/XOFF HANDSHAKING
  5274.        19         ^S         RESERVED FOR XON/XOFF HANDSHAKING
  5275.        23         ^W         Pause for one second
  5276.        24         ^X       * Execute a program in a DOS shell
  5277.        26         ^Z         END OF FILE MARKER. DON'T USE THIS!
  5278.  
  5279.        EXECUTING A PROGRAM IN A DOS SHELL:
  5280.        This  gives you the ability to run an external program in  a
  5281.        DOS  shell whenever RemoteAccess encounters a ^X embedded in
  5282.        a text file. The ^X is followed by the command line you want
  5283.        to  execute,  and terminated with the pipe symbol  (|).  For
  5284.        example,  to  run an external mail checking utility  when  a
  5285.        user  logs  on  you could embed the following entry  in  the
  5286.        WELCOME.A?? file:
  5287.  
  5288.             ^X\RA\MAILCHEK.EXE *B *F *L|
  5289.  
  5290.        RemoteAccess would then execute the following DOS command:
  5291.  
  5292.             \RA\MAILCHEK.EXE 2400 FirstName LastName
  5293.  
  5294.        Note  that  you  MUST terminate the command  with  the  pipe
  5295.        symbol.  All special DOS shell control codes may be used  as
  5296.        per the type 7 menu function.
  5297.  
  5298.        BEWARE!  Use this feature with caution.  Imagine the  damage
  5299.        that this embedded command could do:
  5300.  
  5301.             COPY \RA\USERS.BBS \RA\FILES\IBM\NEWFILES
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.  
  5308.                                     84
  5309.        If  there is any possibility of a user being able to  modify
  5310.        any  of  the  text files that  your  system  displays,  then
  5311.        disable  the shell feature by using the option in  RACONFIG.
  5312.        "Note to next user"  programs are notorious for this! If you
  5313.        don't  think it ever happens, then maybe this will  convince
  5314.        you.  A local sysop was watching his board one afternoon and
  5315.        noticed  that when a user logged off,  he got the  following
  5316.        message:
  5317.  
  5318.  
  5319.        "Hey,  Joe!  What  sort of a password is ROCKET?  Next  time
  5320.        choose a harder one!!    ... Fred"
  5321.  
  5322.        The  sysop  couldn't believe his eyes.  How could this  have
  5323.        happened?  Well,  the  "note  to next user" utility  he  had
  5324.        installed  a  few weeks earlier was to  blame.  It  actually
  5325.        allowed a user upload a short text file that was appended to
  5326.        the  GOODBYE disconnect file.  "Fred" had simply inserted  a
  5327.        few control characters into the file that would display  the
  5328.        current  user's  first name and password,  which  of  course
  5329.        would  always  be correct for whoever viewed  it.  Well,  it
  5330.        shook that sysop up a bit, as well as teaching him a lesson.
  5331.  
  5332.        Luckily  the ^X feature wasn't enabled,  or  anything  could
  5333.        have happened...
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.                                     85
  5370.        * User Parameter Codes
  5371.        ----------------------
  5372.  
  5373.                Character
  5374.        ASCII#  Combination  Information displayed
  5375.        ------  -----------  ---------------------------------------
  5376.        65        ^FA        Users full name
  5377.        66        ^FB        Location
  5378.        67        ^FC        Password
  5379.        68        ^FD        Business/Data phone number
  5380.        69        ^FE        Voice/Home phone number
  5381.        70        ^FF        Date of last call
  5382.        71        ^FG        Time of last call
  5383.        72        ^FH        A Flags setting
  5384.        73        ^FI        B Flags setting
  5385.        74        ^FJ        C Flags setting
  5386.        75        ^FK        D Flags setting
  5387.        76        ^FL        NetMail credit remaining (cents)
  5388.        77        ^FM        Total messages posted
  5389.        78        ^FN        Last message read
  5390.        79        ^FO        Security level
  5391.        80        ^FP        Total calls to the BBS
  5392.        81        ^FQ        Number of uploads
  5393.        82        ^FR        Kilobytes of uploads
  5394.        83        ^FS        Number of downloads
  5395.        84        ^FT        Kilobytes of downloads
  5396.        85        ^FU        Minutes used today
  5397.        86        ^FV        Current screen length
  5398.        87        ^FW        First name only
  5399.        88        ^FX        ANSI setting (ON/OFF)
  5400.        89        ^FY        "Continue?" prompt setting (ON/OFF)
  5401.        90        ^FZ        Screen clearing (ON/OFF)
  5402.        48        ^F0        Full screen editor (ON/OFF)
  5403.        49        ^F1        Quiet/do not disturb mode (ON/OFF)
  5404.        50        ^F2        Hot-Keys (ON/OFF)
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.                                     86
  5431.        * System Parameter Codes
  5432.        ------------------------
  5433.  
  5434.                Character
  5435.        ASCII#  Combination  Information displayed
  5436.        ------  -----------  ---------------------------------------
  5437.        65        ^KA        Total system calls
  5438.        66        ^KB        Last caller (any line)
  5439.        67        ^KC        Number of active messages
  5440.        68        ^KD        System starting message number
  5441.        69        ^KE        System ending message number
  5442.        70        ^KF        Number of times user has paged sysop
  5443.        71        ^KG        Day of the week (full form)
  5444.        72        ^KH        Number of users in the user file
  5445.        73        ^KI        Time in 24 hour format
  5446.        74        ^KJ        Today's date
  5447.        75        ^KK        Minutes connected this call
  5448.        76        ^KL        Seconds connected (always returns 0)
  5449.        77        ^KM        Minutes used today
  5450.        78        ^KN        Seconds used today (always returns 0)
  5451.        79        ^KO        Minutes remaining today
  5452.        80        ^KP        Seconds remaining today (always 0)
  5453.        81        ^KQ        Daily time limit
  5454.        82        ^KR        Current baud rate
  5455.        83        ^KS        Day of the week (abbreviated form)
  5456.        84        ^KT        Daily download limit (in K)
  5457.        85        ^KU        Minutes until next system event
  5458.        86        ^KV        24 hour format time of the next event
  5459.        87        ^KW        Line number (as set on command line)
  5460.        88        ^KX        TERMINATES THE CALL
  5461.        89        ^KY        Name of current template message area
  5462.        90        ^KZ        Name of current template file area
  5463.        48        ^K0        Number of msgs in selected msg area
  5464.        49        ^K1        Number of current template message area
  5465.        50        ^K2        Number of current template file area
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.                     
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.                                     87
  5492.        Modem string translation
  5493.        ────────────────────────────────────────────────────────────
  5494.  
  5495.        RemoteAccess recognizes certain characters embedded in  your
  5496.        modem  initialise  strings,  and  converts them  to  special
  5497.        functions. The supported characters are:
  5498.  
  5499.        ^  Raise DTR, modem will answer the phone.
  5500.  
  5501.        v  Lower DTR, disconnect if connected.
  5502.  
  5503.        ~  Wait for 1/4 of a second before continuing
  5504.  
  5505.        |  Send a carriage-return [CR] to the modem
  5506.  
  5507.  
  5508.  
  5509.  
  5510.  
  5511.  
  5512.  
  5513.  
  5514.  
  5515.  
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.  
  5552.                                     88
  5553.        Questionnaire script language
  5554.        ────────────────────────────────────────────────────────────
  5555.  
  5556.        Questionnaire   script  files  are  stored  in  the   system
  5557.        directory  and have the extension .Q-A.  Each file is  plain
  5558.        ASCII,  and  contains one command per  line.  The  available
  5559.        commands are listed below. Note that the command interpreter
  5560.        is case-insensitive,  so the command "Ask" could be  entered
  5561.        as "ASK" or "ask". 
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.  
  5570.  
  5571.  
  5572.  
  5573.  
  5574.  
  5575.  
  5576.  
  5577.  
  5578.  
  5579.  
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.  
  5588.  
  5589.  
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.                                     89
  5614.        Ask <Len> <Var num>
  5615.        -------------------
  5616.  
  5617.             Example : Ask 15 3
  5618.  
  5619.        Waits  for  the  user  to input a string that is  up  to  15
  5620.        characters long,  and stores the string in the variable <Var
  5621.        num>.  Valid values for <Len> are 1 to 255. <Var num> may be
  5622.        any number between 1 and 20.
  5623.  
  5624.  
  5625.  
  5626.        ChangeColor <Foreground> <Background>
  5627.        -------------------------------------
  5628.  
  5629.             Example : ChangeColor 7 1
  5630.  
  5631.        Changes the colour of the text if the user has ANSI graphics
  5632.        enabled. Valid colours are:
  5633.  
  5634.             <Foreground>                        <Background>
  5635.             ------------                        ------------
  5636.  
  5637.             0    Black                          0   Black
  5638.             1    Blue                           1   Blue
  5639.             2    Green                          2   Green
  5640.             3    Cyan                           3   Cyan
  5641.             4    Red                            4   Red
  5642.             5    Magenta                        5   Magenta
  5643.             6    Brown                          6   Brown
  5644.             7    Light Grey                     7   Light Grey
  5645.             8    Dark Grey
  5646.             9    Light Blue
  5647.            10    Light Green
  5648.            11    Light Cyan
  5649.            12    Light Red
  5650.            13    Light Magenta
  5651.            14    Yellow
  5652.            15    White
  5653.  
  5654.  
  5655.  
  5656.        ClearScreen
  5657.        -----------
  5658.  
  5659.             Example : ClearScreen
  5660.  
  5661.        Clears  the  user's  screen if  he/she  has  enabled  screen
  5662.        clearing.
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.                                     90
  5675.        Display "<Text>"
  5676.        ----------------
  5677.  
  5678.             Example : Display "Please answer ALL questions|"
  5679.  
  5680.        Displays the specified text on the screen.  The vertical bar
  5681.        is  translated to a line-feed and carriage return.  If  this
  5682.        bar  is  ommitted,  any  following text starts at  the  next
  5683.        character on the same line.
  5684.  
  5685.  
  5686.  
  5687.        DisplayFile <1-8 character file name>
  5688.        -------------------------------------
  5689.  
  5690.             Example : DisplayFile BBSRULES
  5691.  
  5692.        Causes a text file to be displayed in the same way as a menu
  5693.        type 5 would be displayed. The text file must be in the text
  5694.        file directory, and have the extension .ASC/.ANS.
  5695.  
  5696.  
  5697.  
  5698.        EndIf
  5699.        -----
  5700.         
  5701.             Example : EndIf
  5702.  
  5703.        Signifies the end of an IF statement.
  5704.  
  5705.  
  5706.  
  5707.        If <Var num> = "<String>"
  5708.        -------------------------
  5709.  
  5710.             Example : If 5 = "Perth"
  5711.  
  5712.        The  IF  command  compares the  contents  of  the  specified
  5713.        variable number with <String>. If the two do not match, then
  5714.        all following lines are skipped until an ENDIF statement  is
  5715.        encountered.
  5716.  
  5717.  
  5718.  
  5719.        GetChoice <Valid choices> <Var num>
  5720.        -----------------------------------
  5721.  
  5722.             Example : GetChoice YN 2
  5723.  
  5724.        Waits  for the user to enter one of the characters in <Valid
  5725.        choices>, and stores the response in the variable <Var num>.
  5726.  
  5727.  
  5728.  
  5729.  
  5730.  
  5731.  
  5732.  
  5733.  
  5734.  
  5735.                                     91
  5736.        ListAnswer <Var num>
  5737.        --------------------
  5738.  
  5739.             Example : ListAnswer 5
  5740.  
  5741.        Displays  (to the screen) the contents of the variable  <Var
  5742.        num> followed by a CR/LF.
  5743.  
  5744.  
  5745.  
  5746.        OutputAnswer "<Descriptor>" <Var num>
  5747.        -------------------------------------
  5748.  
  5749.             Example : OutputAnswer "Hobbies  : " 6
  5750.  
  5751.        Outputs  <Descriptor>  followed  by  the  contents  of   the
  5752.        variable  <Var  num> to the questionnaire answer  file.  The
  5753.        answer file is given the same name as the questionnaire file
  5754.        but has an extension of .ASW.
  5755.  
  5756.  
  5757.  
  5758.        PostInfo
  5759.        --------
  5760.  
  5761.             Example : PostInfo
  5762.  
  5763.        Outputs  the user's name and some other information  to  the
  5764.        answer file.
  5765.  
  5766.  
  5767.  
  5768.        Quit
  5769.        ----
  5770.  
  5771.             Example : Quit
  5772.  
  5773.        Terminates the questionnaire and returns to the BBS.
  5774.  
  5775.  
  5776.  
  5777.        SetFlag <Flag set><Flag number> <ON|OFF>
  5778.        ----------------------------------------
  5779.  
  5780.             Example : SetFlag C3 OFF
  5781.  
  5782.        Turns on or off the specified user flag.  <Flag set> is "A",
  5783.        "B",  "C" or "D",  and <Flag number> is a number between one
  5784.        and eight.
  5785.  
  5786.  
  5787.        SetSecurity <Security level>
  5788.        ----------------------------
  5789.  
  5790.             Example : SetSecurity 10
  5791.  
  5792.        Simply   sets  the  user's  security  level  to  the  number
  5793.        specified. The level may be any number from 1 to 64,000.
  5794.  
  5795.  
  5796.                                     92
  5797.        BATCH FILE EXAMPLES       
  5798.        ────────────────────────────────────────────────────────────
  5799.  
  5800.        These examples are not usable in their presented form.  They
  5801.        are provided as a starting point for your own batch files:
  5802.  
  5803.  
  5804.        Using RemoteAccess stand-alone (ie. without a mailer)
  5805.        -----------------------------------------------------
  5806.  
  5807.        :START
  5808.           Cd \RA
  5809.  
  5810.           REM Run the main program:
  5811.           RA -E20
  5812.  
  5813.           REM User logged off, cycle back:
  5814.           if errorlevel 20 goto START
  5815.  
  5816.           REM RemoteAccess exits to the batchfile with errorlevel 7
  5817.           REM once a night:
  5818.           
  5819.           if errorlevel  7 goto CLEAN
  5820.  
  5821.           if errorlevel  3 goto START
  5822.  
  5823.           REM An errorlevel of 1 or 2 means a fatal error, an
  5824.           REM errorlevel of 0 means that ESCape was pressed while
  5825.           REM in "wait for call" mode - so we quit:  
  5826.           goto END
  5827.  
  5828.        :CLEAN
  5829.           REM Do nightly message and user maintenance with RAUSER 
  5830.           and RAMSG
  5831.           goto START
  5832.  
  5833.        :END
  5834.           echo RemoteAccess HQ Line 1 Down.
  5835.  
  5836.  
  5837.        NOTE  :  Unlike some other BBS packages,  RemoteAccess  will
  5838.        ALWAYS exit back to DOS (or your batch file) after a  caller
  5839.        logs  off.  This means that you can only run in  stand-alone
  5840.        mode with a batch file that will recycle back to restart the
  5841.        main program.
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.                                     93
  5858.        Using RemoteAccess with a mailer (FrontDoor or BinkleyTerm)
  5859.        (using either TosScan or Echogen to process mail)
  5860.        -------------------------------------------------
  5861.  
  5862.        :START 
  5863.           cd \RA
  5864.  
  5865.           REM Run the main program and run the mailer in a "shell".
  5866.           REM The *M tells RemoteAccess to swap out of memory 
  5867.           REM before running the mailer.
  5868.  
  5869.           REM Either FrontDoor : RA -m\FD\FD.EXE*M -E20
  5870.           REM   or BinkleyTerm : RA -m\BT\BT.EXE*M -E20
  5871.  
  5872.           REM Any errorlevels that RemoteAccess does not understand
  5873.           REM it passes back to the batchfile:
  5874.  
  5875.           if errorlevel 150 goto CLEAN
  5876.           if errorlevel  99 goto UNPACK
  5877.           if errorlevel  20 goto START
  5878.           if errorlevel  10 goto END
  5879.           if errorlevel   5 goto NET&ECHO
  5880.           if errorlevel   4 goto ECHO
  5881.           if errorlevel   3 goto NET
  5882.           goto END
  5883.  
  5884.        :CLEAN
  5885.           REM Do your nightly maintenance here. In this example
  5886.           REM the mailer is set to exit at errorlevel 150 nightly.
  5887.  
  5888.        :UNPACK
  5889.           REM Toss incoming mail
  5890.           REM Either : TOSSCAN toss
  5891.           REM     or : ECHOGEN -A -P -T -U
  5892.           goto START
  5893.  
  5894.        :NET&ECHO
  5895.           REM Net and EchoMail needs to be exported from the 
  5896.           REM message base.
  5897.           REM Either : TSUTIL export
  5898.           REM     or : MAILSCAN
  5899.  
  5900.        :ECHO
  5901.           REM Export EchoMail.
  5902.           REM Either : TOSSCAN scan
  5903.           REM     or : ECHOGEN -A -E -P
  5904.           goto START
  5905.  
  5906.        :NET
  5907.           REM Only export NetMail
  5908.           REM Either : TSUTIL export
  5909.           REM     or : MAILSCAN
  5910.           goto START
  5911.                 
  5912.  
  5913.        :END
  5914.           REM Some fatal error occurred.
  5915.           echo RemoteAccess HQ Line 2 Down.
  5916.  
  5917.  
  5918.                                     94
  5919.        * The Echogen command-line switches shown assume a FrontDoor
  5920.          environment.
  5921.  
  5922.           Note that the particular command-line switches for any of
  5923.        these      utilities  (BinkleyTerm,  FrontDoor,  TosScan  or
  5924.        Echogen)  will vary according to your set up.  All of  these
  5925.        programs are supplied with documentation which will  provide
  5926.        you  with this information.  It is stressed again that these
  5927.        examples are only intended to give you a starting point  for
  5928.        creating your own batch files.
  5929.  
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.                                     95